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“dBASE IL is far, far better 


than a shoehorn” 


Rusty Fraser 
President 
Data Base Research Corp. 


“We laughed when 
our customers asked us 
to put our minicomputer- 
based real-time accounting 
system, The Champion)™ 
on a micro. 

“No way was it going 
to fit, we thought. 

“We'd have to create 
our own database manage- 
ment system and, even 
then, it'd be a tight squeeze. 

“Then we discovered 
dBASE II, the relational database 
management system for microcom- 
puters from Ashton-Tate.” 


“dBASE II was a perfect fit.” 
“dBASE II is a program devel- 

oper’s dream come true. The dBASE II 
RunTime™ module quickly provided 
us with the powerful text editing, 
data entry speed and other ‘building 
block’ capabilities we needed to 
develop and deliver a new Champion 
to our customers—the leading real- 
time on-line accounting system avail- 
able for a micro.” 


The short cut to success. 


The dBASE II RunTime module 
has helped a lot of program devel- 





opers like Data Base Research become 
successful software publishers. 
For more about dBASE II and 
RunTime, contact Ashton-Tate 
10150 West Jefferson Boulevard, 
Culver City, CA 90230, (800) 437-4329, 
ext. 217. In the U.K., call (0908) 568866. 
For more about The Champion, 
call Data Base Research at (303) 987-2588. 


ASHTON ‘TATE 


7 dBASE II and RunTime are registered trademarks of Ashton-Tate. 
e Champion is a registered trademark of Data Base Research Corporation. 


©Ashton-Tate 1983. 
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ROBOTICS ¢ DATA ACQUISITION « PROCESS CONTROL 
FORTH: FOR Z-80°, 8086, 68000, and IBM® PC 


© FORTH programs are instantly 
portable across the four most 
popular microprocessors. 


@ FORTH is interactive and con- 
versational, but 20 times faster than 
BASIC. 


® FORTH programs are _ highly 
structured, modular, easy to 
maintain. 

® FORTH affords direct control 
over all interrupts, memory loca- 
tions, and i/o ports. 


@ FORTH allows full access to 
DOS files and functions. 


© FORTH application programs 
can be compiled into turnkey COM 
files and distributed with no license 
fee. 

® FORTH Cross Compilers are 
available for ROM’ed or disk based 
applications on most micro- 
processors. 





Z-80 and 8080 FORTH require 48 Kbytes RAM. 8086 and 
68000 FORTH require 64 Kbytes RAM. Disk formats avail- 
able include: 8’’ standard CP/M SSSD, Northstar 51%" QD, 
Kaypro 5%’"’, Apple 5%'’, Micro-Mate 5%’’, MS-DOS 
5%'’', Osborne 5%’'’ DD, and Victor 9000. Most other for- 
mats can be special ordered. 


MasterCard 





FORTH Application Development 
Systems include interpreter/compiler with 
virtual memory management and multi- 
tasking, assembler, full screen editor. de- 
compiler, utilities, and 130 + page manual. 
Standard random access files used for 
screen storage, extensions provided for ac- 
cess to all operating system functions. 


Z-80 FORTH for CP/M®2.2 or MP/M Il, 
$50.00; 8080 FORTH for CP/M 2.2 or 
MP/M ||, $50.00; 8086 FORTH for CP/M-86 
or MS-DOS, $100.00; PC/FORTH™ for 
PC-DOS, CP/M-86, or CCPM, $100.00: 
68000 FORTH for CP/M-68K, $250.00. 


FORTH + Systems are 32 bit implementa- 
tions that allow creation of programs as large 
as 1 megabyte. The entire memory address 
space of the 68000 or 8086/88 is supported 
directly for programs and data. 


PO PORTIA © 2. ccc accw canes $250.00 
8086 FORTH + forCP/M-86...... $250.00 
68000 FORTH + forCP/M-68K ... $400.00 


Nautilus Cross Compiler allows you to ex- 
pand or modify the FORTH nucleus, recom- 
pile on a host computer for a different target 
computer, generate headerless and ROM- 
able code. Supports forward referencing. 
Produces executable image in RAM or disk 
file. No license fee for applications. Pre- 
requisite: Application Development System 
for host computer, $300.00. 


FORTH Native Code Compiler, requires 
Z-80 FORTH, CP/M 2.2, $100.00. 


| 
Laboratory Microsystems Incorporated et 
/ | 4147 Beethoven Street, Los Angeles, CA 90066 
Phone credit card orders to (213) 306-7412 —_ ebruay2123. 138 
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Extension Packages 


Software floating point (Z-80, 8086, PC only), 
$100.00; AMD 9511 support (Z-80, 8086, 
68000 only), $100.00; Intel 8087 support 
(8086, PC only), $100.00; Advanced color 
graphics (PC only), $100.00; Symbolic 
interactive debugger (PC only), $100.00; 
PC/TERM Communications/file transfer for 
Smartmodem, $60.00; Cross reference 
utility, $25.00; PC/GEN (custom character 
sets, PC only), $50.00; Curry FORTH Pro- 
gramming Aids, $150.00; Hierarchical file 
manager, $50.00; B-Tree index manager, 
$125.00; B-Tree index and file manager, 
$200.00; QTF+ Screen editor for IBM PC, 
$100.00; 


AUGUSTA, Ada subset compiler from Com- 
puter Linguistics for Z-80 CP/M 2.2 systems, 
$90.00. 

“Starting FORTH” tutorial by Brodie, soft- 
cover, $16.00. 

INTEL 8087-3 Numeric Coprocessor, 
$250.00. 


83 -— Standard version of all application 
development systems available soon. All 
registered users will be entitled to software 
update at nominal cost. 





Z-80 is a registered trademark of Zilog, Inc.; CP/M is a 
registered trademark of Digital Research, Inc.; IBM is a 
registered trademark of International Business Machines 
Corp.; Augusta is a trademark of Computer Linguistics; 
dBASE II is a trademark of Ashton-Tate; PC/FORTH and 
PC/GEN are trademarks of Laboratory Microsystems Inc. 
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Introducing the new RX-80. 


fa 








printer this good 
could only come from one company. 








Take a look at the new Epson RX-80 with a critical eye 
and you'll know what we mean. Epson printers are 
put together with manufacturing tolerances in the 
micron range. And meticulously checked for quality — 
one at a time. 

Our reliability rate is approaching perfection. 
Which means you'll probably never — ever — have a 
problem with your RX-80. 

Frills at a no-frills price. 

Just because the RX-80 is affordable doesn’t mean 
we've left off the goodies. You get 128 different 
typestyles with a resolution so sharp you have to look 
twice to make sure it’s dot matrix. You get bidirec- 
tional printing, logic seeking, and a speed of 100 char- 





acters per second. And you even get programmable 
forms control, graphics, and a special Quiet Mode to 
keep the noise down. 
This is your printer. 
No matter what computer you own — or will own — do 
yourself a favor and make sure your printer is an 
Epson RX-80. 
We build them to be the finest printers on earth. 
No matter how small the price. 


Number one. 
And built like it. EPSON AMERICA, INC. 
3415 Kashiwa Street, Torrance, CA 90505 


Please call (800) 421-5426 for the dealer nearest you. In California (213) 539-9140 
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This month we are pleased to present a special issue on telecommunications. We 
appreciate the response to the issue and regret that we could not include all of the 
material that was submitted. We will try to present other items on the subject in later 
issues. Here, however, we hope that you will find an interesting variety of topics. 

As was noted briefly in the VPC article, the complete code listing was sufficiently 
large that we included only some of the illustrative routines. We are willing to publish 
the rest of the code, however, if there is sufficient interest. Those interested in seeing 
the remainder of the VPC level one system may drop the editors a note indicating this, 
or simply use the editorial response card included with the magazine. 


* * * 


Our referee program is now in place and working. As we explained in the initial 
call for volunteers, these referees are people who offer their thoughts and suggestions 
on material we are interested in publishing in DDJ. We are very please with the useful 
comments we are receiving, and we extend our thanks to all those who have offered 
their services. 

This is the first issue in which we have really made use of the new referees. While 
we will publish a complete list of the board of referees next month, we would like to 
thank the following members for their timely insights on this issue: 


Robert Blum, David Kirkland, Baker & Botts 
Contributing Editor, DDJ Patrick Lynch, 


Patrick Burnstad, Lands End Computers Tandem Computers Inc. 

Keith Coye, Software Consulting Corp. Darryl E. Rubin, Rolm Corp. 

Mel Cruts, Triology Joseph Sharp, Micro Science Assoc. 
A. Gomez, Telecomp, Inc. Charles Wilde, IEEE, ACM 


My thanks also to David Harris of PCC’s PCNET Project for his assistance. 


* * * 


We have a number of useful topics planned for the near future. Many people have 
called looking for a runtime library for Small-C v2, presented in the December 1982 
and January 1983 issues of DDJ. This spring we will publish the long-awaited library. 
In addition, we hope to have some other items available for use with the compiler. 
You will of course see more of our usual fare—languages, tools, algorithms, and so 
on—as well as a few surprises. Next month, we begin a two part article on a public-key 
data encryption system. 

Talk to you next month. 


) Cl 


Reynold Wiggins 





Writer’s Guidelines: All items should be typed, double-spaced on white paper. Listings should be 
produced by the computer, using a fresh, dark ribbon on continuous white paper. Please avoid 
printing on perforations. Requests to review galleys must accompany the manuscript when it is 
first submitted. Authors may receive a copy of the complete writer’s guidelines and the current 
compensation schedule by sending a self-addressed, stamped envelope. 


See 
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More Forth Writeability 


Dear Dr. Dobb, 

Before I begin, this is a /etter, not an 
article — so please don’t pay me yet! I re- 
ceived my first DDJ yesterday (whoopee, 
my own copy) and was not disappointed. 

I was delighted that you decided to 
reprint Harvey Glass’s article ‘““Towards a 
More Writeable Forth Syntax’’ and thus 
make it available to us masses. There is a 
growing awareness, despite the jealous 
attempts at standardization by the purist 
elite, that Forth is simply not readable 
(or writeable) enough for broad accep- 
tance. A group of languages is being de- 
veloped in an attempt to make it more 
palatable and consistent. These include 
STOIC (J. M. Sachs, S. K. Burns, ““STOIC 
— An Interactive Programming System 
for Dedicated Computing,’’ Software — 
Practice and Experience, Vol. 13, 1-16, 
1983), PISTOL (E. E. Bergmann, “PISTOL 
—A Forth-like Portably Implemented 
STack Oriented Language,’’ DDJ, No. 76, 
Feb. 1983), and a modification of 
PISTOL which I am in the process of 
developing called REPTIL. 

The most important departure of 
these languages from Forth is that a string 
is also a fundamental data type. Thus 
every name begins life as a lowly string 
and can be subsequently manipulated or 
converted to a more elite verb which 
“does”? something by simply assigning it 
an action using the colon defining verb. 
In REPTIL, for example, a definition for 
SQUARED could be: 


"SQUARED DOES: DUP * :END 


This is a true ‘‘Reverse Polish”? approach. 
Forth defining words have an inconsistent 
‘‘infix’’ format, thus: 


: SQUARED DUP * ; 


The second major departure is that 
compilation is done on a line basis rather 
than compile and execute on a word-by- 
word basis. In some cases execution can 
be deferred over a few lines. The various 
structured constructs are thus allowed in 
both immediate and colon definition 
; modes. 

The syntax proposed by Harvey Glass 
is delightful — it considerably improves 
readability. I don’t believe that Reverse 
Polish is less natural than Infix; in fact, in 
a recent article on Creole languages (D. 
Bickerton, ‘‘Creole Languages,”’ Scientific 
American, July 1983) we see that postfix 
notation, “The poor people all potato 
eat,” or prefix notation, “Work hard 


these people,” is more “‘natural’’ than our 
formalized Infix heritage. What, then, is 
the source of Forth’s lack of readability? 
One reason is the cryptic symbolism, 
where nondescript characters like ““@” 
“ey? “¢ >? and ‘*.”’ take the place of more 
suggestive verbs fetch, store, include, and 
‘‘=*? (or pop-and-display ). Another rea- 
son is that most humanoids prefer to 


One Board 


lIEEE-696 / S-100 BUS 


22 


associate their objects with names, rather 
than have them nebulously floating around 
on stacks. In Forth-type languages, how- 
ever, all constants and variables are global, 
and their use thus considerably clutters 
up the structured modular nature of the 
programs. The concept of a local param- 
eter, as well as the use of NOP’s in the 
form of parentheses and commas, is a 


© Computalker, 1983 
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major breakthrough in this matter. 

The use of parentheses has been re- 
cently proposed by Bergmann (E. E. 
Bergmann, “‘Languages & Parentheses” — 
planned for a future issue of DDJ — Ed.) 
for use in Forth-like languages, however 
not as simple NOP’s. They are controlled 
by syntax checking in that execution is 
deferred until matching parentheses are 
established. The comma will surely upset 
the purists, as will the use of < DEFINE 
in place of ‘‘:”.. How can we throw away 
the cryptic ethnic symbolism of Forth 
with such disregard of tradition? Easily! 

The REPTIL equivalent representa- 
tion of the Ackermann function presented 
by Harvey Glass would be as shown in 
Figure 1 (at right). A few words of ex- 
planation are in order. All relational 
operators ask the question: Is it true or 
false? Thus they are all followed by a 
question mark, e.g., =0? — is TOS equal 
to zero? The wording of the conditional 
branch is designed for readability; I can- 
not accept the topsy-turvy Forth “IF 
— ELSE — THEN” hence they have been 
respectively replaced by ‘“?THEN — 
2? ELSE — ? END.” 

The parentheses are those proposed 
by Bergmann and the comma is the NOP 
of Glass. STOIC originally proposed the 


vocabulary stack technique, in which, for 
instance, ASSEMBLER< will push the 
assembler vocabulary on the vocabulary 
stack and > pops it. Thus LOCAL> isa 
system vocabulary which does not have a 
permanent branch point. When invoked, it 
is linked to the latest current vocabulary. 
:IS defines a constant (it is a value), 
and :HAS similarly defines a variable in 


the normal sense (it has a value, which can 
change); thus invoking I and J (defined as 
constants in the LOCAL< vocabulary) 
simply pushes their respective values to 
the stack. 

Sincerely, 

Issy Urieli 

225 Highland Ave. 

Athens, OH 45701 





‘ACK DOES: 
LOCAL< ‘I :IS ‘J :IS 
| =0? ?THEN {J1+} 
?ELSE J =0? ?THEN 
{11-,1} ACK 
?ELSE 
{{J1-,4£1,J1- } ACK } ACK } 
?END 
?7END > 
‘END 
Figure 1. 


REPTIL Equivalent Representation of the Ackermann Function 
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Curious about Ackermann 


Dear Editor, 

: The function defined by Harvey Glass 
in the Nov. ’83 issue is not the same 
“Ackermann function” as defined by 
Petersen in Forth Dimensions, III, 3, pp. 
89-90. (Peterson’s version is stiown in 
Figure 2 at the right). 

The fig-Forth code which Petersen 
gives to implement this function is gar- 
bled. Glass’s standard Forth code is better, 
but still not correct. A correct implemen- 
tation of the above function can be had 
by replacing the DUP on the second line 
of Glass’s Figure 1, with an OVER. 

I am curious about the origin of this 
function. Who is Ackermann, and where 
did he publish a definition of this func- 
tion? Of what use is the function other 
than testing recursion in programming 
languages? Can any of your readers help 
with these questions? 

Having asked the above, I imagine you 
may be curious to know how I can be so 
sure that Petersen’s definition is “correct” 
and Glass’s is “‘incorrect.’? The answer is 
that Glass’s definition leads to infinite 
recursion with an unbounded increase in 
the depth of the recursion for all non- 
trivial values of the arguments while Peter- 


sen’s leads to large, but finite recursion. 
Sincerely, 


Paul E. Condon 
260 Devonshire Blvd. 
San Carlos, CA 94070 


Merci, Morrow 


Dear Editor, 

I purchased a Morrow Micro Decision 
from Priority One Electronics when they 
held their grand opening -in Irvine. It is 


the first factory-assembled computer I. 


have owned. For $2100, I got the com- 
puter with two double-density 5%4-inch 
drives (192K each), 64K RAM, WordStar, 
Basic, Microsoft BASIC, Correct: it, Logi- 
calc, and Personal Pearl, the MDT 20 ter- 
minal, and COEX 80 printér. 

The system worked wonderfully well 
for about a month, but then began occa- 
sionally to give the dreaded BDOS error 
on B. As it seemed to be getting worse, I 
loaded the system in my car, and drove to 
Irvine. At the store, I set it up, and of 
course everything worked perfectly. For 
about three hours I thrashed it on every 
piece of software it had failed on, to no 
avail. So I bought some new disks and a 
disk head cleaning kit and ‘oaded it all 
back in the car. 

Once home everything worked well 
again for almost two months. The key 
phrase is ‘“‘almost two months.” To be 
exact: 89 days from the date of purchase 
drive B quit. As I did not’ wish to drive 
from San Diego to Irvine again, I called 
and asked about warranty repair. Priority 
One in Irvine told me to call Morrow. I 


. 


Dr. Dobb’s Journal, February 1984 








ACK( 1, J) = J+ for 1=0 
= ACK( I-1, 1 ) for J=0, |1>0 

= ACK( 1-1, ACK( I, J-1 ) ) 
forJ>0, |1>0 


Figure 2. 


Petersen’s Version of the Ackermann Function 


really wasn’t expecting a cheerful recep- 
tion from Morrow, but the lady I spoke 
with was extremely courteous and asked 
if I had contacted the dealer. I replied 
“yes,”? and then she said she would call 
me right back. About 20 minutes later 
she did and asked if I could mail the 
computer in. Of course I could, but I 
explained that I am in the Navy, and 
asked if she could have it back in less 
than three weeks since I was going over- 
seas. Well, I know that things take time. I 
really didn’t expect to have it back, but 
I wanted to have the computer overseas 
with me. Can you believe they would try? 
To shorten this up, they did. And 
even a note inside telling me my diagnosis 
of the problem was correct. I am amazed. 
Of course you probably have heard good 
things about Morrow before, but I can’t 
even get that kind of service on my 
$16,000 car. I wanted to make sure they 
got their kudos. The computer has been 
with me now for four months on a ship 
overseas, and that means vibration and 
infrequent use. The little jewel has held 
up marvelously — in fact, so well that I 
would seriously investigate nearly any- 
thing before hardware for a- fault. I 
haven’t even named this one yet, maybe 
Clark, for Clark Kent — you know, Super- 
man in plain clothes. 
In Navy talk, 

super job, Morrow. 

ETC Howard L. Howell 

USS Fletcher DD992 

FPO San Francisco, CA 96665 


“Bravo Zulu” for a 


A Plea for Xitan Help 


Gentlemen: 

I don’t know how to tell you how 
much help you have been to me in my 
constant learning about computers. Even 
When I don’t understand 90% of the 
magazine, I read through. Each month it 
gets easier. 

~ Right now I could use a favor from 
one of your readers. I am the proud owner 
of a Xitan computer. That’s right, Xitan. 
The trouble is the documentation needed 
for repair must still be the property of 
the first owner. I sure don’t have it. 

If anyone out there has the sche- 
matics, etc., for a Xitan, please let’s get 






together. 
Thank you for being there. 
Yours very truly, 
Larry Litwin 
1935 La Habra Blvd. 
La Habra, CA 90631 


HELP for Readers 


Dear Editor: 

I wish to announce that the Small-C 
Help Facility, as published in the October 
1983 issue, is now available from Pyramid 
Systems, Inc. of San Marino, California. 
Those who wish to use the package but 
don’t relish typing it in by hand ought to 
appreciate the low cost nature of this 
source. 

Thanks to those who have written 
concerning the package. I will be happy 
to keep DDJ’s readers infoemed of any 
known bugs and fixes. 

Sincerely, 
John Staneff 
Route 1, Box 801 


Ellensburg, WA 98926 BBJ 









Real-World 
Applications 


Are you interested in: 





Measurement a control? 
- Hardware construction? 

¢Optoelectronics? 

eInterfacing to external 

devices? — , 

eLow cost robotics? 
eStepper motors? 
*EEPROMs? 














The Computer Journal 


is a magazine for those who interface, 
build, and apply micros. Subscription 
price $24/year in the U.S. (12 issues). 


PO Box 1697D Kalispell MT 59903 
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DR. DOBB'S CLINIC 


by D. E. Cortesi, Resident Intern 








System Languages 

We seem to have hit a community 
nerve with our blast at current compilers; 
some of you are actually writing. Great! 
Let’s review somebody else’s opinions for 
a change. 

Most everybody agrees that we need 
a portable language for systems program- 
ming, in an implementation that produces 
efficient object code. Even Steve New- 
berry, who markets a structured assembler, 
likes the idea. He writes, “I suggest you 
take a look at Leor Zolman’s BDS C (for 
the 8080) and Mark De Smet’s C88 (for 
the 8086). They are so good that it is 
often hard to justify the use of structured 
assembly packages like my SAL/80. But 
there are, and I believe will long continue 
to be, situations in which ... a high level 
language is simply not appropriate for the 
job. In those cases the structured assem- 
bly language provides the most econom- 
ical solution.” 

Thanks for the tips, Steve. BDS C 
scores high in most published benchmarks 
and has an enthusiastic user group. How- 
ever, it differs from the Unix standard at 
a number of points. The advantage of 
Aztec (and perhaps other C compilers) 
is its close match to Unix C. Standardiza- 
tion allows program portability, and 
that’s supremely important in today’s 
software market. Here’s another point: 
most textbooks on C are based on the 
Unix standard. When a compiler deviates, 
it puts impediments in the way of the 
independent student. It’s hard enough to 
learn a language on your own without 
having to translate the examples in the 
book. 


Jim Howell of San Jose, CA, com- 


piled our sort program under Introl C,- 


using OS-9 on a 1 MHz SS-50 system. 


He reports a linked object file of about 


10K bytes (versus our 16K) and execution 
times that were comparable (except for 
writing, which was only slightly slower 
than reading). He notes that our IG- 
NORAD constant might well have been 
required because of a blank line at the 
end of the input file. Very possible. 


David King of Woodside, CA, did an 
informal benchmark comparing Aztec C, 
Microsoft’s BASCOM, and Digital Re- 
search’s PL/I-80 and CBASIC. The test 
program leaned hard on floating point 
accuracy and looping. The fastest execu- 
tion time came from PL/I-80 (10 seconds 
versus 15 for BASCOM, 16 for CBASIC, 
and 19 for Aztec C). PL/I and BASCOM 


produced 9K object files, versus Aztec’s 
11K. Compile times were comparable. 
Only PL/I and CBASIC were able to pro- 
duce the correct answers to the limit of 
their precision. 

King takes off from these results to 
reach some conclusions on the relative 
merits of the languages involved. This is 
something we all have to be careful 
about. It is impossible to benchmark a 
language; one always benchmarks an 
implementation. Every aspect of com- 
piler performance — portability, execu- 
tion time, object size, compile time, and 
numerical accuracy — is a product of the 
implementation. We can live with just 
about any Algol-descended language for 
systems programming, so long as its 
implementation adheres to a standard and 
produces efficient object programs. 


David Clark of State College, PA, 
sent a bulky package of helps for Dwight 
Irving, who was struggling to implement 
the UCSD p-System. With them, Clark 
sent some helpful comments on Aztec C: 

“The failure to link the ‘write’ func- 
tion that you mentioned is not an error. 
The standard I/O library includes that 
function for system-level disk I/O. The 
library and the ‘write’ function are both 
described in K &R. 

“The slowness associated with redi- 
recting output to a disk file is a problem 
with the Aztec version of the library. 
Console I/O (stdin, stdout, stderr) is 
normally done one character at a time. 
When redirecting output to a disk, the 
I/O is still done a single character at a 
time. Since no buffering is done, a sector 
must be read or written for each char- 
acter. [Aha!] Most CP/M implementa- 
tions perform redirected I/O by saving 
the characters in a buffer that is some 
multiple of the sector size. When the 
buffer becomes full or the file is closed, 
the entire buffer is written at once. 

“The size of the code file is due to 
the way the library is implemented. When 
the library is created, all of the functions 
present in one file will be compiled into 
a single module. At link time, the library 
is scanned for needed functions. When 
one is found, its entire module is linked. 
I have two other versions of C that con- 
struct the library by compiling just one 
function at a time. They can then link a 
single function. Of course, building a 
library can be pretty tedious when you 
have dozens of functions to change. 
[That’s why God made submit files, 
David. | 


“There is a public domain rework of 
the Aztec library that remedies these two 
defects. Redirected I/O has been cleaned 
up and is much faster. The library files 
have been broken into much smaller 
pieces, too. The library is mostly the 
work of Herb Shulz and can be obtained 
from a friend of a friend of a friend... .” 


Jack Purdum of Indianapolis, IN, has 
another perspective on the size of a C 
run-time library: 

“I’m not unbiased on C compilers 
(we market one that competes with 
Aztec). However, all compilers suffer 
similar limitations in regards to a number 
of your comments. First, printf(), scanf(), 
and fprintf() are very large functions 
because they are required to do so many 
things. Your program uses only a fraction 
of the power of these functions. This 
‘H-bomb-to-kill-an-ant’ problem comes 
with using built-in functions from the 
library. If code size is important [when 
the heck is it not?) writing a new func- 
tion that does only part of what the com- 
plete function does is one solution — your 
xprint() is an example. We (Ecosoft) have 
compiler switches that allow an integer 
printf() to be used, thus avoiding linking 
the floating point routines. Another 
switch avoids the file 1/O options when 
doing just screen I/O. While this helps, it’s 
not a total solution.” 

You make an important point, Jack. 
The scanf() and printf() functions are 
defined to convert between any data type 
and ASCII. Furthermore, the conversion 
string argument that guides them may be 
a variable; ergo, the compiler can’t know 
at compile time which conversions are 
actually required. As a result, a single 
call of 


printf(‘‘hello”’) 


may cause the linking of the library 
routines for conversion of signed and 
unsigned integers, longs, floats, you name 
it. And they link other support routines, 
so any printf() call will cascade just about 
the whole run-time library into your 
program. 

We can think of two solutions. First, 
instead of your compiler switches, why 
don’t you put the printf() and scanf() 
functions in a separate library, and dis- 
tribute two versions of that library? One 
version would support only strings and 
short integers; the other would be full- 
function. Name the one you want in the 
linker command line. Use macro facilities 
cleverly enough, and the two versions of 
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the functions could be compiled from the 
same source file. 

Second, why do the standard func- 
tions have to be written in C? Sure, Drs. 
K & R showed model support functions 
in The C Programming Language, but 
aren’t they to be taken as just that, 
models? Use them to get your compiler 
off the ground; use them in Beta-test; use 
them as executable functional specifica- 
tions. But when it comes to the final 
version of the most heavily used code in 
every user program, shouldn’t you hand- 
code them in the target assembly lan- 
guage? Isn’t it the whole point of a high 
level language that one person, the com- 
piler designer, takes on the burden of using 
the machine effectively, thus lifting that 
burden from the shoulders of many 
people? A hand-tuned assembly version 
of printf() ought to run rings around a 
compiled version, and the payoff, multi- 
plied over thousands of user programs, 
more than justifies the effort. 


Keep Talking 


This discussion is based on our asser- 
tions that a portable, efficient, systems 
programming language is desperately 
needed, and that no existing microcom- 
puter compiler is adequate to meet the 
need. We’d make a third claim: compilers 
are aS poor as they are only because we 
users have not demanded better ones. 

If you disagree with any of these 
claims, feel free to write. Write too if you 
have counter-examples: compilers that 
do produce efficient code, cases where 
assembly language is needed regardless, 
or proof that certain language features 
can’t be made efficient no matter how 
much demand there is. Also, does any- 
body know who did the first optimizing 
compiler? It was a Fortran for the IBM 
360 done in the late 60’s, but we’ve 
lost the reference. What other optimizers 
have you used, and how well did they 
work? 


Move Over, Ray 


Last month we tromped all over Bob 
Blum’s columnistic territory and prom- 
ised, in a fit of naked ambition, to move 
in on Ray Duncan’s this time (we colum- 
nists have strong territorial instincts). All 
this comes about because what goes into 
this column is — in the absence of reader 
input, hint hint — whatever happens to 
have passed over the columnist’s desk or 
through his keyboard in the weeks pre- 
ceding the deadline. 

What was passing through our key- 
board in recent weeks was the final draft 
of a book on Concurrent CP/M, in sup- 
port of which Texas Instruments had very 
generously loaned a Professional Com- 
puter with CCP/M installed. The Profes- 
sional Computer, or ‘“‘Pegasus’? as we 
insiders call it, worked very well, and its 





CCP/M did, too. This version of the sys- 
tem uses the “‘3.1 BDOS,” the same level 
of file system as used in CP/M Plus. (You 
can tell the 3.1 BDOS by its use of the 
INITDIR command to set up disks for 
timestamping.) Its BIOS and system inte- 
gration had been breathed on by DRI, 
which may explain why we found no 
bugs or performance problems in it. 

There was a command missing, how- 
ever. CCP/M does not implement the ‘“‘file 
search path” notion of CP/M Plus. There 
is only a single “‘system drive” which will 
be searched when a command can’t be 
found on the default drive. 

There are various ways of choosing 








the system drive. The default choice is set 
when the system is generated. In at least 
the first edition of CCP/M for the IBM 
PC, the system drive is set automatically 
as the highest-lettered drive in the sys- 
tem. The generic version of CCP/M in- 
cludes a command, SYSDISK, that will 
change the system drive. In the TI version 
of CCP/M, the system disk is either 
diskette drive A: or, if you have one, the 
hard disk on drive E:. The SYSDISK 
command was omitted; there is no way of 
changing the system disk. 

There are times when you might 
want to change the system drive. If you 
have only diskette drives, the system 


“O-PRO4 blows 
OBASE Il away 





We now complete complex applications 


in weeks instead of months. JJ 





Says Q-PRO4 user, Richard Pedreili, President, Quantum Systems, Atlanta, GA 


44 As a dBASEII beta test site the past two years, we were reluctant to 
even try Q-PRO4. Now we write all our commercial applications in Q-PRO4. 
We find it to be an order of magnitude more powerful than dBASEII. 

We used Q-PRO4’s super efficient syntax to complete our Dental 
Management and Chiropractic Management Systems much faster. Superb 
error trap and help screen capabilities make our finished software products 


far more user friendly, too. 


In my estimation, any application programmer still using outdated 3rd 
generation data base managers or worse, a 2nd generation language like 


BASIC, is ripping himself off. 99 


Runs with PCDOS, MS-DOS, CP/M, MP/M, CP/M86, 


MP/M86, TurboDOS, MmmOST, MUSE, and NSTAR. 


PRICE: 8-bit single-user — $395; 8-bit multi-user and 
16-bit single-user — $595; 16-bit multi-user — $795. 
Money-back — e Author's lock up package 


none : ished gseseerraens are freely 
transportable between operating systems 
@ Multi-user with true record and file lock. 


08 


For Q-PRO 4 demonstration, go to nearest MicroAge store or other fine dealer. 




















WAN 


Quic-n-e@asi products inc. 


136 Granite Hill Court, Langhorne, PA 19047 (215) 968-5966 Telex 291-765 


CP/M. MP/M. CP/M86. and MP/M&6 are Tademarks of Dignai Research Turb0OS. MmmOST. MUSE. NSTAR. MS-DOS ano PCDOS are trademarks of Software 2000. TeleVideo Systems. 0S M., Molecular Microsoft and IBM, respectively 
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disk should at least be different from 
A:, the usual default drive. A: will be 
searched anyway, so the second search 
is wasted unless the system disk is an- 
other drive. Again, if you have an elec- 
tronic pseudo-drive, you might want 
to make it the system drive after you 
have brought the system up and ini- 


SYSDISK was an unnecessary handicap 
on the TI system. 

With a little research, we figured out 
how to change the system drive. A short 
assembly program does it by putting the 
drive number in the System Data Area 
(see Listing One, below). As a bonus, you 
can change four lines to create another 


drive. The temporary drive is the drive on 
which the system will build scratch files, 
especially the VOUT files of data from 
buffered consoles. BB 


Reader Ballot 
Vote for your favorite feature/article. 


tialize it. We thought that the lack of a program which will change the temporary Circle Reader Service No. 190. 





Clinic Listing (Text begins on page 10) 


SYSDRIVE [ d: ] 

SYSDRIVE is a simple, 8080-model, program that reports on and 
sets the system drive-letter under Concurrent CP/M. Some 
CCP/M systems are delivered with a SYSDISK command that does 
the same job. 


Given no command argument, SYSDRIVE merely reports which drive 
is the system drive. Given a drive-letter and colon, it will 
set that drive as the system drive. 

THE DRIVE-LETTER IS NOT VALIDATED. 


The same source file becomes a TMPDRIVE command by changing 
the indicated ((operands)). 


we 00 Ce we We We We Oe WE WO we we wew5o S86 WO we Ce OO 


9 


Bdos equ 224 3; interrupt number for BDOS 
C WritesStr equ 9 ; code to display a string 
S_ Sysdat equ 154 3 code to get System Data Area 
Sysdisk equ 4Bh 3; offset of Sysdisk in SDA 
Tmpdisk equ 50h ; offset of Tmpdisk in SDA 
9 

CSEG ; everything in the code segment 

ORG 005Ch 
Operand drive rb 1 3 First-operand drivecode 

ORG 0100h ; code begins here 
9 

mov c1,S_ Sysdat 

int BDOS ; BS:EX -> SDA 

mov al,ES:Sysdisk[BX] ; ((ES:Tmpdisk[BX])) 
9 

push bx ; save regs while.. 

push es ; --displaying msg 

add al,'A' 3; make drive printable 

mov msgi_ drive,al ; and put in msg 

mov e1,C WriteStr 

MOV dx,offset msg 

int BDOS ; display msg 

pop es ; recover saved 

pop bx ;. «registers 
9 

mov al,Operand drive 





A 





Dr. Dobb’s Journal, February 1984 








or al,al ; was a drivecode given? 
jz exit -\ (if tot, Stop) 

; 
dec al ; OO=A, 01=B, etc 
mOv ES:Sysdisk[BX],al 3; ((ES:Tmpdisk[BX])) 
add al,'A' 5; make new drive printable 
mov msg2 drive,al ; and put in msg 
mov cl1,C WriteStr 
mov dx,offset msg2 
int BDOS > eeand print it 

) 

exit: retf ; far-return ends program 

: 

msg 1 db 'System' 3; (('Temporary') ) 


db todrive-ig* 
msgi_ drive rb 1 ; filled in from SDA 
db et tas tus Ss" 


9 
msg2 db 'System' 3; (('Temporary')) 
db ' drive set to ! 
msge drive rb 1 ; filled in from operand 
db NS hae ty SS 
3 


end 


End Listing 


Tah le @lii(e= Correspondence 


SEATTLE OFFICE LYME STREET OFFICE 


ray 
Memo editor: Enter mail Mode: Memo editor: Enter mail Mode: 
Date: 11/30/83 Date: 11/30/83 
Special deliverys Special delivery: 
From mailboxs 709 - Jack Spears i 


Return receipts From mailbox: 101 - Will Pierce Return receipts 
To mailbox: 101 - Will Pierce Copies toa: To mailbox: 102 - John Fail Copies tos 


Subject: Electronic Mail Manager Attached files: Subject: Board Meeting tomorrow Attached filess 


Ear IK ON The board meeting will be held tomorrow morning at 10 
Since the installation of the "EMM" system, our ALN A.M. This Electronic Mail Manager sure makes communications 
inter-office correspondance has become effective and él 

more productive. The system is areal "bargan” at 


even 10 times the price! See you next week. 


. 2 -2 dt 
LA OFFICE EE a Evie 1 


G SOUTH STREET OFFICE 


between our offices easy and fast. The new budget forcast is 
attached in xyCALC format. Let me know if you approve. 


From mailbox: 102 - John Fail Return receipts From mailbox: 906 - Lara Wilks 
te mel Lhone: «LOU Witt Pieres Copies tos To mailbox: 101 — Will Pierce Copies ta: All 
Subject: Board Meeting tomorrow AEtechee «tiess Subjects New Product Release Attached files: No 


vt ; 

The “Gudget forcast looks good except that’ tT veve We have completed the integration testing of the 
revised the year end projections to include new market fortran version of COMMX on the DEC 10 with links ac 
trend figures. I have returned the new setup in xyCALC. all ‘the wiceos 
See you at tomorrows meeting! 


itor nter : 
Memo editors: Enter mail Mode: Mend Wditorestater mail mee d 
Date: 11/30/83 
- : Date: 11/30/83 
Special delivery: aes PE 


Special delivery: No 
Return receipts Yes 


The error free file transfers work 
like a dream! The COMMX protocol does it again! 


~ 


IN IN Gis wa (ZoeceyniCom\/ Ell M\/E-ler-ecom Uti iiveme| ot-tron | Mmr-late ILO). NY Ga @ OYA Matfestiton ts eXchange software. 
team-up to provide your office personnel up to 900 mailboxes on your dial-up Inter-Office Network 


Send $20 for your demo disk today! Available for all CP'M 80, CP'M 86 and MS DOS systems. 





Wee 23914 Mobile Street, Canoga Park, CA 91306 © (213) 348-7909 or 634-0733 
(A) HAWKEYE GRAFIX — Modem (300 B): 634.0441 Data 


: 
| 
| 
| 
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CP/M EXCHANGE 


by Robert Blum 








Over the last several months I have 
spent a little time talking about CP/M Plus 
and its new features. All of these discus- 
sions have been from the outside looking 
in, probing no deeper than just below the 
surface. Even from that point of view I 
was very excited about what CP/M Plus 
was built to do and its many new perfor- 
mance options. 

CP/M Plus is now in daily use on my 
machine and is largely responsible for 
turning the tide against V2.2, which has 
been retired to second string and bench 
warming. As is the case with most new 
products, there are a few rough edges that 
need to be smoothed out, but nothing 
more serious than cosmetic defe: ts. I still 
have a lengthy wish list of features that I 
would like to have. However, my list now 
contains desirable additions, not items 
that are necessary to plug holes in an in- 
adequate system. 

I will be talking more about CP/M 
Plus regularly in future columns. Some of 
the areas that I have already covered will 
be reviewed in more detail and, where 
appropriate, source code will be made 
available. 

I won’t be getting into a lot of detail 
this month. I want to first share a few of 
my experiences in bringing CP/M Plus up 
for the first time and my initial reaction 
to using it. 


implementation 


I chose to rewrite my BIOS for CP/M 
Plus (V3.0) from the ground up rather 
than attempt to adapt my V2.2 BIOS 
code. This was the most desirable approach 
for me because of a few specific changes 
that I had made to enhance V2.2 which 
would serve no useful purpose under V 3.0 
and could potentially cause unnecessary 
problems. Starting out with a clean slate 
also allowed me to implement many of 
my wish list items without being con- 
cerned about their effect on other sec- 
tions of an already working system. 

Before starting any work I decided to 
write a complete banked BIOS that 
could be used as nonbanked simply 
by changing one IF statement in each 
program module. I also wanted to keep 
all related device-dependent logic in sepa- 
rate modules for ease of debugging. The 
sample routines provided by Digital Re- 
search follow this same scheme and were 
very beneficial not only as a guideline, 
but also as a basis to work from. 

Since I am an advocate of Zilog 
mnemonics, my first step was to convert 


the sample routines from Intel mnemonics 
to the Zilog standard with XLATE2. Each 
module was then edited for aesthetics. 
This step is not necessary if you don’t 
care for Zilog mnemonics or if you want 
to use the sample routines as written. 
There is no real benefit to using one 
method over the other. It’s simply a 
matter of personal choice. No matter how 
you go about putting your system to- 
gether, I do strongly suggest that you at 
least use the sample routines as a guide- 
line. Otherwise, you will waste a lot of 
valuable time in unnecessary coding and 
debugging. 

I was then ready to begin the real 
task of writing, or rewriting in some 
cases, all the routines to interface V 3.0 to 
my hardware configuration. I was sur- 
prised when I finished after only three 
days because I had originally planned on 
spending about a week writing code. I 
think a week is a more realistic time esti- 
mate unless you are able to do as I did 
and shut yourself away to avoid any dis- 
ruptions. 

I was fortunate in being able to sal- 
vage a major portion of my V2.2 disk 
controller code which accounts for at least 
half of my complete system. Adding the 
Extended Disk Parameter Blocks and re- 
lated control structures was an easy task 
that required very little new coding. The 
time-consuming parts were the new mod- 
ules: character I/O module (CHARIO), 
boot routine (BOOT), bank selection 
and memory-to-memory move routine 
(MOVE). To complete my suite of mod- 
ules I used DR’s main module, BIOS- 
KRNL, almost verbatim. Everything fell 
into place quite easily and looked like it 
should work without a considerable de- 
bugging effort. I wouldn’t realize how 
complex the placement of code between 
common and banked memory would be 
until I started testing in a banked environ- 
ment. But this is another subject altogeth- 
er that I will talk about a little later. 


It was my intention from the begin- 
ning to limit the complexity of my first 
test system as much as possible in hopes 
that my debugging effort would also be 
simplified. When generating my first 
nonbanked system with GENCPM, I 
answered ‘“‘no”’ to as many questions as I 
could and limited buffer allocations to 
one each for both data and directory. 
Fortunately, luck was with me and on my 
third attempt I had CP/M Plus operational. 

After running a few test programs I 
was confident enough to begin generating 


more test systems with a few more fea- 
tures enabled than the one before it. 
Everything was holding together better 
than I thought it would until I started 
testing my first banked system. 

I was sure that my bank switching 
hardware was stable because I had written 
a diagnostic program to verify its integrity 
and had been using it daily with V2.2 
without any problems. Using SID to assist 
in debugging a banked system is no help 
at all because once a bank is switched out 
SID will typically crash or cause its own 
share of strange errors. What is needed is 
a program that does not depend on the 
lower map of memory or any BDOS func- 
tions to operate. Asit turns out, repeatedly 
changing the code, relink-editing and 
generating, and testing were practically 
the only way I had to get my banked ver- 
sion up. 

Even though I had a banked ver- 
sion operational on the first day, it was 
prone to sporadic failures. Finally, after 
two weeks and the eradication of a few 
bugs, I was completely operational with 
a stable system. During this time I learned 
a lot about how CP/M Plus works by 
reading and rereading the manuals and 
just poking around in an attempt to find 
out what was going wrong. 

Based on my experience, I cannot 
overly stress the importance of studying 
the manuals that come with the CP/M 
Plus system before charging off to bring it 
up. Even though the manuals have been 
drastically improved, a number of very 
important tricks are well hidden in the 
text. In addition, CP/M Plus is a com- 
pletely new system with very little resem- 
blance to its predecessor. 


User Report 


Using CP/M Plus is ajoy. The extended 
command editing feature available on 
banked systems saves a nontypist, like 
myself, a lot of time. If a keying error is 
made in the middle of a command line it 
is no longer necessary to backspace and 
erase to the incorrect character and then 
retype the remainder of the line. With 
CP/M Plus you simply type CTL-A to 
nondestructively backspace over each 
character in the command until you reach 
the error. You then have the choice of 
using either CTL-G to delete one or more 
characters at the cursor position or of 
making insertions by typing the new text. 
If the command line is lengthy you can 
also skip to the right or left end of the 
string with a single keystroke. 


ge re 
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The entire command line can also be 
redisplayed even after return has been hit 
and a transient program has executed. 
One of my most common errors is to mis- 
spell file names which causes difficulties 
at the retrieval stage. Provided no other 
keyboard entries have been made, hitting 
CTL-W will redisplay the last command 
line entered and allow further editing. 
This one feature alone has saved me from 
many frustrating moments at the key- 
board, especially when I am in a hurry. 
One other very practical use for this 
facility is when the same program must 
be run against a number of files. Rather 
than setting up a submit procedure you 
can now easily edit the same command 
line as many times as necessary. 

And last but not least, multiple com- 
mands can be entered on one line by 
separating them with an exclamation 
mark. 

I couldn’t be happier with the key- 
board editing features except for one 
gaping hole. There is no way to redefine 
the control sequences assigned to individ- 
ual functions. I would have thought that 
this medieval practice, akin to the Chinese 
water torture, would have been outlawed 
in a new development effort. 

Submit file processing is as automatic 
as you want it to be. After proper specifi- 
cation of the search path with the SET- 
DEF program, a search is made for the 
.COM file specified in the command line. 
If it isn’t found the search is automatically 
continued, only this time a file type of 
SUB is used. When the desired file is 
found, SUBMIT.COM is loaded for exe- 
cution and the specified file is used as 
input. 

Program input can be imbedded in 
the submit file by preceding each input 
line with a less-than sign. In the case of 
an errant program that tries to read pro- 
gram data after the file is exhausted, 
further input requests are directed to the 
keyboard. In addition, system commands 
are protected from being read as program 
data. 

Limited conditional submit file proc- 
essing can be done by prefixing system 
commands with a colon. This indicator 
tells the CCP to check the system error 
code for a nonzero value, and if true, skip 
the command. 

And in my estimation the most use- 
ful new feature is nested submit files. You 
are no longer prohibited from calling sub- 
mit procedures from other submit proce- 
dures. This is especially useful when 
doing any kind of batch processing. 


Supercharged 


Quite an uproar was heard when the 
truth was known about the LRU buffer- 
ing logic of CP/M Plus. The most heated 
public discussion took place in DDJ a few 
months ago. Dave Cortesi took the time 
to uncover the LRU buffering logic, only 


to find that for sequential files, there 
wasn’t any. The fact is, LRU buffering is 
disabled for sequential file processing. 


Fortunately, Digital Research is not a 
company to be kicked for very long before 
rectifying a situation. The application 
note at the end of this column changes 
the LRU buffering logic to give equal pri- 
ority to buffer usage regardless of how a 
file is accessed. Exactly what this change 
means in terms of program runtime is 
unknown as yet because I haven’t run any 
benchmarks to make a comparison be- 
tween a before and after system, although 
from outward appearance I would think 
that a substantial savings is in order. 


Tips 

When coding the physical device 
names in the character table, make sure 
they are entered in upper case. The DE- 
VICE transient program converts all key- 
board input to upper case before search- 
ing for a match in the character table. 


Application Note 


CP/M Plus V3.0, Patch 13, 5/1/83 
BDOS Patch 02 


Copyright © 1983 by Digital Research Inc. 

CP/M Plus and SID are trademarks of Digital 
Research Inc. Compiled September 1983. 
Printed with permission of Digital Re- 


Color Video Contraller/ 








Ree se 


ASL 





V-100 


Keyboard Encoder/RS-232 









128 key capability w/shift, control, repeat. TXD, RXD 


port; uses 2661-2N USART w/internal software pro- 


@ S-100 compatible. 
@ 8 foreground colors; 8 backgroud colors. 
@ R-G-B;h, v, sync; composit video; luminance: composit sync outputs. 
@ Multi-level gray-scale if desired. 
@ 8K memory standard (4K character, 4K attribute) up to 32K optional (16K/16K). 
@ Uses latest Signetics 2670A, 2674B, 3675B CRT chip set. 
@ Software programmable attributes, CRT timing. 
@ Hardware smooth scroll (26748). 
e [/O mapped (independant buffer mode). 
@ 2671A keyboard encoder, 
serial port. 
@ Full handshake RS-232 serial 
grammable baud rate generator. 
@ Parallel I/O port, latched w/handshake (8 X 371). 


e@ Assembled, tested, 100 hr. burn-in, 1 yr. warranty. 


PRICING... 
VelQ0s Tao Aiea eu ask 8K Ram, RS-232, Parallel............ $349.00 
eis vce nu awe do bs Poe Mr eee Re ees ADD 120.00 
Weer ice ein. nk a Ras os Keyboard Bacoder:.. 65 6.6 oS ADD 40.00 

PEL AWE Oe oe cick owe we oho be ees wkd ohbee ele pe STOCK TO 6 WEEKS 


DEALER & OEM INQUIRES INVITED 


AGI / BOX 40, ALPINE, CA 92001 
(619) 445-9071 


AMERICAN SCIENTIFIC COMPUTER CORP. 
A California Corporation 


Circle no. 2 on reader service card. 
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search (but see the Editor’s Note in the ® change the LRU algorithm that manages 
data DCBs (banked systems only). 
Products and Serial Numbers that Require Up- © correct the problem that occurs if a 
BIOS READ ERROR. is encountered 
during login on a permanent drive. 


listing). 
dating: CP/M Plus V3.0, serial numbers 2-000- 
00001 through 2-000-XXXXX 


Program: RESBDOS3.SPR, BNKBDOS3.SPR, 
BDOS3.SPR 


Error Description: 


correct errors that occur if directory 
write operations are performed to disks 
set to Read Only (R/O). 


These patches do the following: ® correct random record I/O error that 


e clear the multiple command buffer if 
CTRL-C is encountered. 


occurs when the random record number 
is greater than 3FOOOh. 


Patch Procedures: 


Make a backup copy of RESBDOS3.SPR, 
BNKBDOS3.SPR, and BDOS3.SPR before 
making any changes. The program SID is 
required to make the changes. The 
changes are made by the sequence of 
commands in the Listing (below). BB 


Reader Ballot 
Vote for your favorite feature/article. 
Circle Reader Service No. 191. 





CP/M Exchange (Text begins on page 14) 


15C>REN RESBDOS3.SAV=RESBDOS3.SPR 
15C>SID RESBDOS3.SAV 
Cse-Lp COM 

CP/M 3 SID — Version 3.9 
NEXT MSZE PC. END 

9988 8908 BY1BB CCFF 
#S41A : 

G41A F8 FC 

@41B C8 . 

#5797 

8797 @3 @7 

798 06 . 

#WRESBDOS3.SPR 

@Gl@h record(s) written. 
#G@ : 


15C>REN BNKBDOS 3.SAV=BNKBDOS3.SPR 
15C>SID BNKBDOS3.SAV 

CrStu COM 

CP/M 3 SID - Version 3.9 

NEXT MSZE PC END 

3688 3608 8108 CCFF 


#A529 

0529 CALL 2D24 
G527C 3". 

#S6C6 

G6C6 88 14 

HOC] C2 

#SB92 

G@B92 AB 9/7 

B93 09 . 
#S13B1 

13Bl CO BB 

13B2 CD. 
#A15ED 

15ED CALL @EEB 
15F® JINZ 13FF 
15F3 LHLD 2871 
15F6 CMP M 
15F7 NOP 

15F8 NOP 

15F9 JZ 13FF 
15FC JIMP 2D4g 


L5SPE CALL 1252 


1602 CALL 1258 
1695. 

#41640 

1648 JZ 2D6A 
ina... 

#SW19DB 


19DB 14F@ 2D83 
19DD CDC8 . 
#A1B16 

1B16 CALL 2D76 
1B19 . 

#SW1LBA4 

1BA4 14F@ 2D83 
1BA6 B9C2 . 
#SW24F6 

24F6 1E9@ 2D7D 
24F8 36C3 . 
#SW25FG 

25F@ 1E9@ 2D7D 
25F2 52C3 . 
#SW261B 

261B 1E98 2D7D 
261D A4CD .~ 
#SW2704 

2704 2519 2D3A 
2766 20CD . 
#A2C92 

2c92 CALL 2D36 
2095 

#A2CE5 
2CE5 LDA 2D39 
2ZCE8 ORA A 
2CE9 NOP 
2CEA . 

#S2D@5 

2D05 F8 F6 
2D06 28 . 

#S 2DGD 

2DGD F6 F8 
2DGE 28 . 
#A2F24 


2624 LEXI H,@ 


EDITOR’S NOTE: 

This is still a prelimi- 
nary version of patch 13, 
not an official patch. 
It may contain some errors 
(though we have not heard 
of any yet). It is thus not 
endorsed for application 
by Digital Research. It 
is currently under review 
at DRI, and we had ex- 
pected it to be approved 
by the time we went to 
press. Unfortunately, word 
of last-minute delays 
came too close to press 
time for us to withhold 
the listing. Thus we in- 
clude this caveat. DRI will 
keep us updated, and we 
will let you know of its 
disposition and any 
changes that might be 
made, 





(Continued on page 18) 
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Buy Hardware/Software at Wholesale, 
And Save On Software Rentals, 


Save hundreds of dollars when you 
buy DIRECT from America’s.Num- 
ber 1 Computer Buying Service 
at just 8% above DEALER WHOLE- 
SALE PRICES, plus shipping. 


Members receive The Personal 
Computer NETWORK’s Giant 
Catalog featuring thousands of 
products and the lowest prices 
on the widest selection of com- 
puter software and hardware in 
the nation! 


RENT BEFORE YOU BUY — Mem- 
bers are eligible to join The NET- 
WORK’s Business and Game 
Software Rental Libraries for a 
much smaller fee than other soft- 
ware rental services. And The 
NETWORK’s rental charges are 
far less — just 20%-25% of the 
Member WHOLESALE PRICE! 


Join The NETWORK today for as 
low as $8 for one year (or $15 for 
two years) and receive all these 
exclusive, money-saving benefits: 


1. REAL BUYING CLOUT—Byy at just 8% 
above DEALER WHOLESALE PRICES, plus ship- 
ping. (On credit card orders there is a 3% service 
charge.) 


2. CONVENIENT SHOP-AT-HOME 
CATALOG 


3. KNOWLEDGEABLE SERVICE 
CONSULTANTS 


4. FULLY INSURED FAST HOME 
DELIVERY 


5. OPTIONAL BUSINESS SOFTWARE 
RENTAL LIBRARY — Members join for just 


$30 per year in addition to the basic membership 
fee. Rent business software at just 20%-25% of 
The NETWORK’s low prices for a 7-day period 
(plus a 3-day grace period for return shipping). 100% 
of your rental fee applies towards purchase. 


6. OPTIONAL GAME SOFTWARE 
RENTAL LIBRARY —Members join for just 


$10 per year in addition to the basic membership fee. 
All the Same conditions apply as for benefit five 


7. SPECIAL SAVINGS BULLETINS — 


Save even more on limited-quantity merchandise! 


8. DISCOUNT COMPUTER BOOK 
LIBRARY —Save up to 50%! 


9. MEMBERSHIP SATISFACTION 
GUARANTEE — it you are not satisfied, notify 


us within 30 days to receive a 100% money-back 
refund. 


10. PRODUCT SATISFACTION 
GUARANTEE — | you are not satisfied with 


any hardware, return it within 15 days for a 100% 
money-back refund. 


All items subject to availability, prices subject to change without notice 


Copyright ©1983. PC NETWORK INC 


Low prices, fast home delivery and 
two software rental libraries are. _ 
only the beginning! The NETWORK 
is your source for everything from 
memory chips to mainframes—and 
it’s all just 8% above wholesale, 
plus shipping. 


HARDWARE 


Monitors (color and monochrome) 

Printers 

Complete Systems 

Disk Drives (full/half height, add-on/add-in) 
Multi-Function Boards 

Graphics Boards 

Modems 

Local Area Networks 

Memory Chips (all speeds available) 

S-100 Components 


SOFTWARE (rent or buy!) 


Business Scientific 
Recreational Data Bases 
Compilers Educational 
Word Processors Graphics 
Utilities CP/M-MS/DOS 


SUPPLIES & ACCESSORIES 


Blank Diskettes (all formats) 
Paper Stock 


Ribbons 
Print Wheels 
Cables 


And More! 










NETWORK 
SAVE ON urcraves: Seen 
Disk Drive Retail | Wholesale 

Two Tandon $574 $350/ 
TM 50-2 Half pair pair” 
Height DS/DD 
, Retail Wholesale 






64K Chips $11 each $5.10 ea.* 


“NETWORK Members pay just 8% over the 
wholesale price, plus shipping. 






SPECIAL V.I.P. MEMBERSHIPS 


Available at $15 per year or $25 for two years. 
V.1.P. Members receive additional benefits: 


BOTH SOFTWARE RENTAL LIBRARIES 
» FOR $35 in addition to the V.I.P. membership fee. 


2 EXTENDED 10-DAY SOFTWARE RENTAL 
» PRIVILEGES (plus3 days for return shipping). 









ADVANCE NOTIFICATION OF SPECIAL 
» SAVINGS BULLETINS. 






CALL TOLL FREE 


) 1-800-621-S-A-V-E 


in ilinols call (312) 372-4488 
Your Membership Validation Number: 0463 
You can validate your membership number 
and. if you wish, place your first money- 
saving order over the phone by using your 


VISA, MASTERCARD or AMERICAN EX 
: PRESS. Our knowledgeable service consul- 
tants are on duty Mon-Fri 8 AM to 7 PM. Sat 
9 AM to 5 PM CST. 
“—=/ Call now...Join the PC NETWORK 


and start saving today! 


Circle no. 55 on reader service card. 


Choose hardware and software 
from hundreds of manufacturers, 
including: 


¢ Altos 






- MicroPro 


- Amdek ¢ Microsoft 

¢ Apparat ¢« Morrow 

- AST _ ¢ Motorola 

* Ashton-Tate + NEC 

> Atari - Northstar 

- CDC ¢ Okidata 

* Coleco « Peach Tree 

* Columbia ¢ Princeton 

* Commodore - Quadram 

- Corona - Sanyo 

* Cromemco ¢ Sierra On-Line 

- DEC - Software 

- Digital Publishing 
Research - Softword 

- Eagle - Tandon 

- Epson * Tecmar 

* Franklin - Texas 

- Hayes Instruments 

- IBM * Toshiba 

- 1US * Visicorp 

* Lotus Zenith 





OS EE SS EE ND 


THE NETWORK: MEMBERSHIP APPLICATION 


YES! Please enroll me as a member in The 
NETWORK™ and rush my catalog featuring thousands o* 
computer hardware and software products, all at just 8% 
above DEALER WHOLESALE PRICES. | will also receive 
all the other exclusive, money-saving services available 
to Members. 


( 

i 

! 

i 

; | am under no obligation to ae anything. My complete 
Satisfaction is guaranteed. 

: Please check () all boxes that apply: 

| Basic Membership 

Pe (] One-year membership for $8 

' (] Two-year membership for $15 (SAVE $1) 

; 

[ 

i 

‘ 

i 

i 


(] Business Software Rental Library for $30 add'l. 
per year— members only 


L] Games Software Rental Library for $10 add'l. 
per year— members only 


Special V.I.P. Membership 
() One-year membership for $15 aa 
_] Two-year membership for $25 (SAVE $5) 
C) 


BOTH Business and Game Software 
Rental Libraries for $35 add'l. 
per year—V.1.P. members only 


L) Bill my credit card: .—1] VISA 
; (|) MasterCard [1 American Express Exp. 
Date 
Account Number: 





mo.year 


: (] Check or money order enclosed for $ 











Name 
Address Apt. No. 
S| SENS OMe ZIP 

i Telephone ( ) 








J My computer(s) is: 1 IBM PC (] Apple I!  TRS-80 
i © Atari ( Commodore Other 


i Signature ~ 
(Signature required to validate membership) 
Givers saaecs sonra pane OREUS GEER SERS GREK? FEED cm ches ORE Wee enor oxi 






PC NETWORK | 


omens AS A NETWORK Member Only! sum 




























CP/M Exchange (Listing continued, text begins on page 14) 


2F27 SHLD FBBA 
2F2A SHLD FBB1 
2F2D DCX H 
2F2E DCX H 
2F2F RET 

2F3@ SHLD 28F4 
233 °"*SuT: Ss 

ZV 35.:. OLA 2059 
2F38 RET 

2F39 NOP 

2F3A CALL 2D43 
2F3D JMP'<2513 
2Z2F49 CALL 1377 
2F43 LHLD 287B 
2F46 MOV A,L 
2F47 ANA H 
2F48 INn A 
2F49 RZ 

2F4A MOV E,M 
2F4B INX H 
2F4C MOV D,M 
2F4D MOV A,D 
2F4E ORA E 
2F4F RZ 

2F5@ LXI H,28AA 
2F53 LDAX D 
2F54 CMP M 
2F55 JNZ 2D63 
ZAP 56. UAL Hes 
2F5B DAD D 
2F5C MVI A,FFE 
2F5E CMP M 
2F5F JNZ 2D63 
2F62 STAX D 
2F63 LXI H,D 
2F66 DAD D 
2F67 JMP 2D4A 
2F6A CALL 1377 
2F6D LHLD 2871 
2F70 MOV A,M 
2F71 ORA A 
2F72 RNZ 

2F73  MVI M,2 
2F75 RET 

2F76 CALL 1139 
2F79 LXI H,FD17 
2F7C RET 

2F7D CALL 1E9@ 
2F8@ JMP 1139 
2F83 CALL 1162 
2F86 JMP 14F@ 
2F89 . 

#53065 

3865 82 92 

3066 49 . 


#5 327F 
3275. 98 12 
3280 49 . 
#S535A5 
35A5 @8 48 
35A6 @8 21 
35A7 @8 @9 
35A8 88 24 
35A9 88 BG 
35AA 88 21 
35AB 88 OG 
35AC 88 49 
35AD @8 49 
35AE 88 BG 
35AF @@ 91 
35B® O88 24 
35Bl @8 8@ 
35B2 00% 
#WBNKBDOS 3.SPR 
@86Ah record(s) written. 
#G@ 


15C>REN BDOS3.SAV=BDOS3. 
SPR 

15C>SID BDOS3.SAV 

C3 SID COM 

CP/M 3 SID - Version 3.9 

NEXT MSZE PC’ END 

2788 2788 8188 CCFF 

#AQ4C2 

G4C2° CALL 1IE25 

FACS; 

#5642 

642 G8 19 

9643.C2. 

#5846 

9846 54 4B 

9847 06. 

#SD6F 

OD6F CH BP 

9D7@ CD. 

#SW12A2 

12A2 OE86 LE3E 

T2R4. COCs: 

#A13DD 

$30): CALL... TE 3t 

Ric 24 oe 

#SW1463 

1463 @OE86 LE3E 

1465. 78C2 |. 

#SW1B29 

1B29 16A5 1E38 

Lez G3IC3. 

#SW1B8A 

IB8A 16A5 1E38 


LBGl. 3aC 3 || 
#SW1LBB5 
1BB5 16A5 1E38 





tee] 7 LCD’ 


#A20625 


2925 
2928 
292B 
2025 
202F 
2930 
2031 
2934 
2037 
2938 
293B 
2035 
2041 
2944 


LXI H,@ 
SHLD LEBA 
SHLD l1EBIL 
DCX H 

DCX H 

RET 

CALL @AF7 
LXI.H,1LCDF 
RET 

CALL 16A5 
JMP @AF7 
CALL @B2@ 
JMP @E86 


#52097 
2097 82 G6 
2098 06 . 


#S233F 


233F 41 49 
2349 20 . 


#S26AC 


26AC OB 24 

26AD @@ 12 

26AE O88 24 

26AF 88 9G 

26B@ @O . 

#WBDOS3.SPR 

@@4Dh record(s) written. 


# GO 


End Listing 
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programmers 
READ THIS... 


NOW, | KNOW | CAN MAKE BIG MONEY WRITING AND SELLING MY 
PROGRAMS. THIS BOOK TOLD ME WHAT TO WRITE — WHO TO SELL 
IT TO — THOUSANDS OF NAMES, ADDRESSES, IDEAS, GUIDELINES. 


SOFTWARE WRITER’S MARKET” IS A FANTASTIC BOOK! 
















WHO TO SELL YOUR PROGRAMS TO in ® 
THOUSANDS OF COMPANY NAMES AND ADDRESSES. * 
WITH DETAILED LISTINGS SHOWING: ry 
(1) WHAT PROGRAMS PUBLISHERS ARE LOOKING FOR 

(2) HOW THEY WANT YOU TO SUBMIT YOUR PROGRAM 
(3) HOW MUCH THEY PAY — AND WHEN! 

100 CATEGORIES — FROM “ACCOUNTS RECEIVABLE’™® 
TO “GAMES” TO “VIDEO CONTROL” PROGRAMS 

* HOW TO WRITE CLEAR DOCUMENTATION 

* DEBUGGING TECHNIQUES 


Enclose check or money order 
for $19.95 (No C.0.D.’s) to: 
(PF Publications Address 
146 Country Club Lane 
Pomona, NY 10970 
(914) 354-5585 City 


Circle no. 75 on reader service card. 


Micro to Mainframe Connection 





the mind of Man a single large ma- 

chine that could be all things to all 
people: the Main Frame Computer. To 
further Man’s purposes the Main Frame 
Computer grew larger and larger and 
more complex. To tend its every need a 
priesthood of Programmers and Analysts 
evolved. They and only they were per- 
mitted to talk to the large machine. As in 
all priesthoods and cults, they spoke in 
strange tongues that only the large ma- 
chine understood. All others had great 
difficulty communicating with the large 
machine and had to rely on the priest- 
hood so that the machine would be 
bountiful and smile upon them and do 
their work. 

Strangely, the people also found it 
difficult to talk to the priests, for the 
priests were more interested in talking to 
the large machine than to the people: a 
perplexing problem and one that did not 
seem to be amenable to an easy solution. 
Then into this inhospitable land of Babel 
rode a knight on a pure white charger: 
the Microcomputer! 

All at once the people had within 
their grasp the world the priesthood had 
been promising, lo, these many years. 
They no longer needed the priesthood. 
Temples were smashed, large machines 
were shunned, a new day had arrived. All 
the people needed was access to a micro- 
computer and the proper software. Re- 
joice, the people were no longer beholden 
to others; they were in control of their 
own destinies. 

Were it all so easy. Alas, the lack of 
software, the emphasis on Games, the 
difficult-to-understand manuals left the 
people wringing their hands. Perhaps they 
needed the priesthood after all. But in 
spite of the many early woes, software 
got better, people began to talk in fewer 
tongues, and the microcomputers got big- 
ger and bigger. The Programmers soon 
found that they needed a means of ex- 


ong ago and far away there lived in 


by Keith Coye and 


Alvin Grossman 


Keith A. Coye, Consulting Services Cor- 
poration, 7214 Via Maria, San Jose, CA 
95139. 


Alvin Grossman, San Mateo Co. Office 
of Education, 333 Main Street, Redwood 
City, CA 940723. 


Artwork: Joe Murray. 


changing information among the various 
systems, but each machine spoke in its 
own tongue. What was needed was a com- 
mon language for transferring data among 
the various machines. 

Here we leave our fairy tale and re- 
turn to reality, although we very much 
hope that, like a fairy tale, there will be a 
happy ending. Many of us felt that the 
microcomputer was not a threat to our 
‘““empires” but instead was a godsend that 
would extend the boundaries of comput- 
ing and hasten the arrival of true dis- 
tributed processing. Although we were 





Oy THE BEGINNING” 


called foolhardy by many of our contem- 
poraries in the priesthood, it was our per- 
ception that the microcomputer would 
usher in the day of popular computing 
and would effectively allow a melding of 
computing power and communications. 
It would put computing power into the 
hands of the users and, with it, the deci- 
sions on how they would want to use it. 


Planning the Connection 


At the San Mateo County Office of 
Education in the heart of the Silicon Val- 
ley, we began to plan our efforts way 
back in 1980 (it seems like eons ago). At 
that time our Three Year Master Plan 
stated: 

“‘We have taken the view that micros 
are not antithetical to our current envi- 
ronment. In fact, through the develop- 
ment of this plan, the use of a variety of 
computers will result in an environment 
that will be more user oriented and make 
a full spectrum of computational power 
available to all users. We will move from 
being an organization with primarily an 
administrative focus to one that will 


provide the necessary conduits for deliv- 
ery of a wide variety of systems. 

“In addressing this new phenomenon 
it must be remembered that this is a new 
technology and not simply a cheaper or 
necessarily better way of doing things. 
What in fact is happening is that the 
nature of user interaction with computing 
has changed and the range of computing 
applications has expanded dramatically. 
The incorporation of micros into our 
‘systems’ is especially fortuitous at this 
time. It will allow us to be able to off- 
load minor and special-purpose functions 
and to expand our service offerings. It 
will also prolong the life of the current 
large computer (DECsystem-10). In addi- 
tion to what has been traditional com- 
puter center functions, an expanded role 
will be added, that of more far flung tele- 
communications to expand the availabil- 
ity of computing to all districts and 
schools in our service area and to make 
their access easier. 

‘“‘This plan proposes a means where- 
by we will become essentially a network, 
from the smallest micro to the major 
mainframe at our headquarters, with all 
users accessing and being able to obtain 
any files they want and need in a manner 
most advantageous to them.” 

Our goals at that time were explicitly 
stated as follows: 


1. Move toward’ a marriage of micros/ 
mainframes ! 


2. Design an interface between the two 
machines to facilitate the easy com- 
munication and downline loading of 
data despite differences in operating 
systems, disk formats, and text format 
conventions 
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3. Design an easy-to-use system to allow 
““packages’’ of data to be downline 
loaded and then manipulated by a 
micro data base manager 


4. Create a resource group to act as a 
primary “‘help’’ group to teach users 
how best to access and use their data 
bases on the mainframe 


5. Design approaches that would allow 
the mainframe to be a primary storage 
and switching network and allow a 
great deal of the computing to be at 
the local level on micros 


Initial Prototyping 


We decided to prepare a prototype 
implementation connecting the DECsys- 
tem-10 at the San Mateo Center with a 
number of Radio Shack Model IIIs. They 
provided a large population of systems 
and were Z80 based. The choice of the 
Radio Shack Model III was based on the 
large population of this type of system in 
our area and the ease with which we 
could extend our software to other sim- 
ilar 8080-based systems. We felt that this 
would give us a good perspective on the 
challenges of connecting a network of 
non-CP/M systems to the DECsystem- 10. 

One of the first hurdles we faced was 
the choice of programming language for 
this application. We had both micro- 
computer- and mainframe-level coding 
to do and wanted to consider both ease 
of implementation and ease of mainte- 
nance. We evaluated different languages 
as follows: 


1. DECsystem-10 assembly language — a 
good candidate from the perspective 
of its close relationship with the DEC- 
system-10 operating system and the 
ease of communication with operating 
system internals, but a liability since 
we could not transport the code to 
another mainframe or microcomputer 

2. Fortran — a good candidate since 
Fortran runs on most systems, both 
mainframe and micro, but the liabil- 
ities included a lack of good string 
handling and isolation from the critical 
terminal and monitor internals re- 
quired for this type of application 


3. COBOL — again, a good candidate since 
COBOL runs on most systems, although 
it is weak in the area of efficiency and 
in the ability to control modem and 
communications areas 

Further investigation led us to evalu- 
ate an emerging language, C, as a candi- 
date. Lo and behold, it had the structure 
of a very high level language, nearly the 
efficiency of assembly code, and best of 
all was reputed to be highly portable. Off 
we went to choose a good C compiler 


Evaluation of C Compilers 


Very few C compilers were available 
three years ago, so our field of choice was 


rather limited. Most of the C compilers 
for the DECsystem-10 mainframe were 
implemented by universities or schools. 
The manufacturer had no product, so we 
turned to the educational area for help. 

Several versions of C were located at 
the University of Utah and Tufts Univer- 
sity in Boston. The version at the Uni- 
versity of Utah was in development and 
had licensing restrictions that prohibited 
its use as a future commercial product. 
The version created by David Krumme in 
the Mathematics Department at Tufts was 
a good compiler although very newly 
developed. 

On the microcomputer side, the BDS 
C compiler was one of the few that had 
any proven track record for the micro- 
computer community. Despite its non- 
standard library and the difficulty of link- 
ing in assembly code, we chose it as our 
initial compiler. 

We quickly discovered that the non- 
CP/M environment required a special 
library and support for the —TRSDOS 
operating environment. Our strategy was 
to compile the main application code on 
a Z80 development machine under CP/M, 
unload the “‘com”’ file into an Intel hex 
file with an origin suitable for the TRS80, 
transfer the hex file to the TRS80O, and 
create a special loader on the TRS80 to 
create an executable file on the TRS8O. 
Needless to say, this was a complex, time- 
consuming, and often frustrating process. 
The debugging time was astronomical! 
Each bug that was discovered required a 
complete recompilation, unloading, trans- 
fer to the TRS80, and reloading to try 
again. 

It soon became obvious that the pro- 
cess of transporting the code from one 
micro environment to another had to be 
improved. We decided that we must find 
a C compiler that ran on more than Z80- 
based systems, had a standard Unix-like 
library, and allowed easy integration of 
assembly code using standard linking 
loaders. The C code needed to be trans- 
portable to other systems with an abso- 
lute minimum of source code change. 


The Final Selection 


Enter Aztec C from Manx Software! 

Early testing showed that, although 
the compilation and execution speed was 
slightly slower than the BDS C compiler, 
the claims for portability, assembly code 
integration, and standard library func- 
tions were true. We immediately con- 
verted the BDS C source code to the 
more standard Unix-like syntax used by 
Aztec C. 

The communication software, now 
called XPRESS, came to life, and we 
found that the code written in Aztec C 
was portable not only to other micro- 
computers but also to the DECsystem-10 
mainframe. Our strategy was to create 
common code segments for all machines 


and to design “‘personality modules” to 
adapt the specific operating system, 
modem, and communication require- 
ments. The TRS8O version was a success 
and soon requests came in for Televideo, 
Apple, CompuPro, Radio Shack Model 2, 
and Radio Shack Model 16. 

Then the IBM PC was announced and 
the race was on to get the C compiler up 
and running on the PC. Manx had not yet 
released its version for the PC so an alter- 
native vendor, Computer Innovations, 
was selected as an interim candidate. The 
compiler was good in all respects, but it 
did require some modification since it 
did not adhere to some of the I/O syntax 
conventions used by Aztec C. Shortly 
thereafter, Manx released its Aztec C for 
the PC and we decided to continue with 
it for the PC development. 


Software Design 


The internal software design of 
XPRESS is described below. It may be of 
interest to those readers who enjoy the 
more technical side of the communica- 
tions arena. 

XPRESS is designed to allow a com- 
mon memory area to be used as required 
for terminal communications, file trans- 
fer, and general-purpose temporary 
working space during directory sorts and 
file operations. The common area is man- 
aged internally within XPRESS, and the 
user never needs to worry about which 
section of the common area is being used 
at any given time for a specific function. 

A portion of the common memory 
area, the text buffer, is used to receive all 
terminal transmissions from the remote 
computer. A series of pointers to text 
within the buffer allows the user to re- 
view terminal activity even after it has 
scrolled off the screen; automatically 
capture text for use with systems that do 
not support protocol file transfer; and 
provide buffered printing of the text, 
even if the printer runs slower than the 
communications line. 
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XPRESS allows these three functions 
to operate in the text buffer without error 
or interference with each other. The text 
buffer typically takes up as much mem- 
ory as is available after the program is 
loaded. When the text buffer is being 
used only as a review buffer, then the 
buffer simply wraps around to the begin- 
ning as soon as it fills; the last buffer of 
information is always available for review. 

When the text buffer is being used 
for nonprotocol file transfer, the Capture 
pointer keeps track of the contents of the 
buffer. As soon as the buffer is about 95 
percent full, XPRESS stops the transmis- 
sion of additional characters (using 
XOFF) and saves the buffer to a specified 
file before allowing the file transmission 
to restart. 

When the text buffer is being used as 
a printer buffer, XPRESS sends char- 
acters to the printer while buffering in- 
coming characters. If the printer is either 
busy or off line, XPRESS continues to 
fill the text buffer and resumes printing 
when the printer is again available. If the 
printer is so slow that the text buffer gets 
nearly full, XPRESS requests the remote 
system to suspend transmission by send- 
ing the appropriate character, usually 
XOFF (decimal 19), 


Terminal Emulation 


XPRESS emulates a DEC VT100 ter- 
minal in those modes possible on each 
specific microcomputer. These may in- 
clude cursor position, cursor up, down, 
forward, and backward, device status 
report, cursor position report, save cursor 
position, restore cursor position, home 
erase to end of screen, erase to end of 
current line, set graphics rendition, set 
mode, reset mode, and keyboard key 
reassignment as specified in the ANSII 
terminal specification. The VT100 was 
chosen based on the large volume of soft- 
ware written for that terminal and its 
popularity in the mainframe marketplace. 


File Transfer Protocols 


The CRC protocol used in this imple- 
mentation is an extension of that pro- 
posed by Ward Christensen in his Modem 
series programs. It is extended to allow 
the transmission of batches of files and to 
use the CCITT 16-bit CRC algorithm. 
The CRC protocol was chosen for its 
superior error recovery and also because a 
large number of microcomputer bulletin 
board systems already use it for file 
transfer. 

The algorithm (x16 + x12 + x5 + 1) 
is specified as providing detection of all 
single- and double-bit errors, all errors 
with an odd number of error bits, all 
burst errors of length 16 or less, 99.9969 
percent of all 17-bit error bursts, and 
99.9984 percent of all possible longer 
error bursts. (See Computer Networks, by 


char O 
char 1 
char 2 
char 3-130 


char 131 
char 132 


Start of Header (SOH-decimal 1) 

Packet number modulo 64 

Complement of packet number modulo 64 

8- bit data bytes with no encoding of any kind 

Most significant 8 bits of 16-bit CRC per CCITT-16 
Least significant 8 bits of 16-bit CRC per CCITT-16 


Table 1. 


Andrew S. Tanenbaum, Prentice-Hall, 
1981.) The CRC is set to zero at the start 
of each packet received and then accumu- 
lated for each data byte. At the end of 
the packet the CRC is updated with the 
MSB of the CRC and then the LSB of the 
CRC. The CRC should be zero at this 
time if no error occurred in transmission. 

Data are transferred between systems 
by taking a sector of information from 
the disk and surrounding it with identify- 
ing information as well as information 
needed for error recovery. This block of 
data and administrative information is 
often called a packet. The actual packet 
format is as shown in Table 1 (above). 

The ACK character (6 decimal) is 
used as a positive acknowledgement, and 
the NAK character (21 decimal) is used as 
the negative acknowledgement. The re- 
ceiver initiates the connection by sending 
a capital *‘C” character (67 decimal) until 
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Compare Btrieve’s capabilities to 
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it receives the first packet. This ‘“‘C” char- 
acter signals the transmitting machine to 
use the CRC protocol; it then uses the 
ACK and NAK as detailed above to con- 
firm each packet. Packets refused by the 
receiver are retransmitted up to five times 
before giving up. Fatal errors are com- 
municated by sending the CAN character 
(24 decimal) three times to the opposite 
system. 

The file name packet is a special 
packet differing from a standard packet 
only in that it is null filled after the file 
name in the data area. A data packet 
filled with all nulls indicates the end of 
the batch of files being transmitted. 

Note that the CRC protocol requires 
the use of all eight data bits and will send 
ACK, NAK, CONTROL characters, and 
characters with values in excess of 128 
decimal during the normal transfer of 
ASCII and binary information. This pro- 
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tocol, therefore, cannot be used in sys- 
tems that restrict the use of 8-bit char- 
acters in any way. 

The XNET protocol is a fully packet- 
ized protocol useful in cases where the 
line will not allow all characters to pass 
freely. It is a proprietary protocol that 
maps characters into the dense graphics 
printable character set, thus allowing 
transmission over restricted lines. Packet 
size is restricted on configurations using 
the DECsystem- 20 due to the inability of 
the DECsystem-20 to handle packets of 
data sent in bursts of greater than 94 
characters. This protocol has receiver- 
defined parameters, including packet size 
and pre-packet and post-packet termi- 
nators, making it suitable on a large num- 
ber of remote systems. 


Related Software 


Teachers today have a huge selection 
of software to choose from and often 
may lack the time to personally try out 
each package. We felt that a means to 
quickly select and review important facts 
about each available package was needed. 
A data base of software packages was 
developed, which provides the. teacher 
with a means of obtaining a quick over- 
view of all packages that meet specified 
selection criteria. The user may then re- 
quest additional detailed information 
about any software package. 

An example of how this software 
library application works might be help- 
ful at this point. Let’s suppose that a 
math teacher has an Apple computer and 
wishes to provide instruction to the stu- 
dents on how to find the area and volume 
of common shapes and solids. The teacher 
would use the Apple computer to com- 
municate with the mainframe in terminal 
mode and would access the software 
library. application program. Next, the 
teacher would request information on 
those. software packages that run on an 
Apple, whose subject is math, grade level 
is sixth through ninth, and that are either 
available at no charge or commercially 
available. , 

The data base would be scanned, and 
information on the 15 programs in the 
data base that meet these criteria would 
be shown in summary format to the 
teacher. The teacher would then request 





specific information on three packages 
that seem to be most appropriate to the 
needs for the class. Additional informa- 
tion such as cost, system requirements, 
where the package could be obtained, and 
comments by other teachers on the pack- 
age would then be shown to the teacher. 
The teacher could then elect either to 
download the desired public domain 
software directly using XPRESS or to 
contact the distributor for commercial 
packages. 


Future Directions - 3 

It is apparent that school districts 
will continue to migrate toward. micros 
for many applications and accordingly 
will make less use of the mainframe. Put- 
ting into practice one of our major goals, 
which is to put data processing control 
into the hands of the users, we created 
the PIPELINE system. PIPELINE is a 
user-oriented system that works with a 
multiplicity of microcomputers. : 

Using this system, users decide what 
data they need and how they want it 
parameterized for their special reporting 


- or analysis needs. Then, using their micro 


as a dumb terminal, they access the main- 
frame and ask for PIPELINE. They are 
presented with a menu that asks them 
what kind of data they want. If, for 
example, they want personnel data, they 
are routed to a data dictionary that lists 
all of the personnel data elements on the 
system, each sequentially numbered with 
a one-line descriptor. Then they choose 
by number (such as 33, 96, and 101) 
which data elements are to be extracted. 

If additional data from the financial 
system are needed to integrate with the 
personnel data, then the users ask for the 
financial menu and go through the same 
process to extract the needed financial 
data. When the users have extracted the 
defined data, they indicate the data 
should be downloaded to their micro. 
While interrogating the mainframe system 
for information, users may use Boolean 
Logic selectors such as greater than 
( > ), less than ( < ), or equal to( = ) 
in specifying what kinds and ranges of 
data they want (i.e., select teachers whose 
subject = math and who have > 5 years 
of experience). 3 

Once this data has been downline 
loaded in a format.that the users’ micro 
can handle (using XPRESS as the vehicle), 
it then may be further manipulated using 
a local data base manager. 

A complementary approach is the 
use of a software package that allows a 
large mainframe to run microcomputer 
software, including the popular CP/M 
operating system and the large quantity 
of inexpensive programs that run under 
it. With no additional hardware invest- 
ment (such as the purchase of a micro), 
users may use their current terminals and 





operate them as if they were a fully con- 
figured microcomputer; at the same time 
they have the full power of the main- 
frame available. 

The users could, of course, also use 
a micro to downline load any information 
to their floppy disks and run whatever 
programs they wished independently. The 
best of. both worlds, this approach allows 
CP/M and CP/M-based programs, as well 
as stand-alone programs, to run on the 
DECsystems. Except for their speed and 
the fact that they are easily accessed 
remotely over telephone lines and net- 
works, such programs run exactly as they 
do on a microcomputer. 3 

_ Investigation is being done on tech 
niques for data compression and encryp- 
tion to meet the needs of high-volume 
data transfer with security. Among the 
techniques being explored are Hoffman 
coding, repetitive character encoding, 
use of private keys, and more efficient 
protocols. 

The future is bright with promise for 
the connection of today’s new series of 
microcomputer to the traditional commer- 
cial mainframes to provide the strength 
of the mainframe with the flexibility and 
local control of the microcomputer. 
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Communications Protocols: 


Theory and Practice 





ow many of us have not had the 
PH isition of trying to get some 

data from a friend, or some other 
micro or mainframe, only to discover that 
your machine’s MICRO-COMM does not 
communicate very well with the main- 
frame’s TSO or your friend’s PC-LINK? 
By ‘“‘communicate’”’ I mean much more 
than just acting as a dumb terminal; I 
include full file transfer in both directions. 
The problem is an incompatibility of pro- 
tocols between the machines and commu- 
nications packages involved. In order to 
solve the problem, we need to decide just 
what a protocol is, how it works (or 
doesn’t work), and what some typical 
ones look like. 


Starting Simple: 
The XON/XOFF Protocol 

Simply put, a protocol is an agreed- 
upon set of rules for two computers to 
communicate with each other, a ‘“‘verbal 
handshake” between the computers, if 
you will. The simplest such protocol, and 
one with which most of us work every 
day, is the XON/XOFF (or DC1/DC3) 
protocol. Many terminals, such as the 
DEC VT-52 and Zenith Z-19, use this 
protocol to control the flow of data from 
the microcomputer. This illustrates one 
of the first goals of any protocol: To con- 
trol the flow of data. 

The XON/XOFF protocol uses the 
special characters XON (control-Q) and 
XOFF (control-S) to turn on and off the 
flow of data from the other end. CP/M 
uses control-S (XOFF) to stop the flow 
of data to the console, and any other key 
to restart it — a simple implementation of 
the XON/XOFF protocol. Printers often 
use this protocol to prevent their buffers 
from overflowing; a printer will receive 
data at 9600 baud until its buffer is about 
three-fourths full. At this point it will 
send an XOFF to the microcomputer, 
and the microcomputer will (hopefully) 
stop sending data. The printer will print 
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for a while, until its buffer drops to only 
one-fourth full. The printer will then 
send out an XON, and the microcomput- 
er will again send it data. 

In our hypothetical case everything 
worked exactly as it should. In the real 
world things are not so simple and prob- 
lems often develop. For example, suppose 
that your cat pounces on the printer 
cable just as the printer sends out the 
XOFF. You live in Nevada and the air is 
very dry, so the cat has built up a static 
charge as it crept up on the cable. This 
static electricity discharges into the cable 
and the XOFF is drowned in noise. Your 
micro never sees the XOFF and continues 
shoving out data at 9600 baud. Hopefully 
the person who designed your printer’s 
software anticipated this, and your printer 
sends out another XOFF when its buffer 
has only 100 bytes left. This illustrates 
the second goal of any good protocol: 
Error tolerance. Herein lies a very deep 
swamp! 

Admittedly, most printer designers 
probably considered the case we looked 
at above, but how about a very similar 
case? Again, picture your cable getting a 
noise burst, but just as the XON goes out. 
Your microcomputer never sees the XON 
and doesn’t transmit any more data. Most 
printers will allow this situation to con- 
tinue until their ribbons rot and fall off! 
A clever designer might have the printer 
send out XON’s every ten seconds or so if 
the buffer is empty and it is not receiving 
data. This is a third goal of a good proto- 
col: To anticipate and prevent deadlock 
conditions. Not every protocol succeeds 
here, and the success or failure may often 
depend as much on the implementor as 
on the protocol. 


Micro to Mainframe and Back Again 


If you have stayed with me this far 
you can already understand most of the 
reasons why your microcomputer cannot 
talk to your friend’s: they don’t use the 
same protocol. This is also the problem 
with trying to communicate with many 
mainframes. In the real world, then, how 
do we surmount the problem? Well, there 
are some pretty standard protocols in wide 
use. For example, the CLINK protocol 
developed by Larry Hughes and first used 
in his CLINK communications package is 
also used in Crosstalk and in Larry’s later 
package, MITE. (See the SEND/RECEIVE 
article in the August 1982 issue of Dr. 
Dobb’s for some of Larry’s earlier work.) 
The XMODEM protocol, developed by 


Ward Christensen, is in widespread use on 
many different machines and in many 
different implementations, and is in the 
public domain. Let’s take a quick look at 
it. 

XMODEM 


The XMODEM protocol is a reasona- 
bly good protocol, widely used, and par- 
ticularly suited to use on microcomputers. 
A typical transmission would look like 


Sending SB B DDD DDC E 
Machine OL LAAA AAK O 
HK KTTT rts Fi 
HH#HAAA...AAU 
* M 
Receiving A 
Machine 


K 
*One’s complement of the block number. 


This introduces some new terminolo- 
gy. SOH means Start Of Header and is a 
standard ASCII control character that is 
often used to indicate the start of a mes- 
sage. After the SOH is a block number, so 
that XMODEM can tell whether or not it 
has already seen this block or missed a 
block. The second block number is the 
one’s complement of the first, which 
gives some assurance that XMODEM is 
not throwing away a block based on a 
corrupted block number. XMODEM de- 
fines that there will be 128 bytes of data 
following the block number. After the 
data comes the checksum, which is an 
error check code. The transmitting ma- 
chine adds all of the data bytes together 
and transmits their sum (modulo 256) at 
the end of the block. The receiving 
machine also adds the data bytes and 
compares the sum it reaches to the one it 
received. If the two sums match, the data 
is assumed to be good and the receiving 
machine sends an ACKnowledge (as 
shown here); if the sums do not match it 
will send a NAK (Negative AcKnowledge). 
If the transmitting machine receives a 
NAK (or no response at all), it retrans- 
mits the last block sent. It continues re- 
transmitting until it receives an ACK or 
gets too many errors and aborts. This 
gives some assurance that the data will 
arrive correctly and also avoids most 
deadlocks. (See “How Accurate Is Ac- 
curate,” below, for further discussion of 
error detection.) As in our example, the 
transmitting machine sends an EOT (End 
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Of Transmission) to indicate that no 
more data remains after the last block 
has been acknowledged. 


XMODEM, then, meets most of the 
requirements of a good protocol; why 
doesn’t everyone use it? Well, some 
companies like to have their own commu- 
nications packages, so they produce a 
proprietary protocol. Mainframes do not 
use it because they use other protocols, 
most of them much older than XMODEM. 
However, almost all CP/M bulletin board 
systems use it, and some packages (such 
as MITE) support it in addition to their 
own protocols. Even better (if you need 
to talk to minicomputers), there is a 
package called XCHANGE11 that imple- 
ments the XMODEM protocol for DEC 
PDP-11 and VAX minicomputers. So 
XMODEM solves many problems; where 
does it fall short? 





















ow Accurate 





| aslie Brooks and John Rasp 


‘When you are typing data or com- 





transmission error because the wrong 
character shows up on the screen. You 





nt between machines, this method of 
tor checking is inefficient because of 
s character-by-character nature. Thus 
he protocols that have evolved usually 
provide some other means of detecting 





, “How good are these methods of 
Tor detection?” The answer can be- 
le very complicated; people have 
ied Ph. D.s in math for research in 
rea. I put this problem to a friend 
ne who is doing doctoral work in 
~s and he pronounced it “‘inter- 
| esting.” After a few days of study and 
research he told me that if we make a 
| few assumptions, we can get a reason- 
| ably simple answer. 

For the 8-bit checksum, there are 
actually three common ways of calcu- 
ig it; they do not produce identical 
| results. The first method is simply to 
add all of the data bytes together, 
~ modulo 256, and take the result as the 
_ checksum. The second method is the 
, _ same, except that any carries generated 
a e added back into the sum. The third 
- method is to exclusive-or all of the 
_ data bytes together (sometimes called 
_ a longitudinal redundancy check ). The 
_ best accuracy one can, in theory, hope 
th an 8-bit checksum is to miss 
rors in 256. In practice, however, 






















Dr. Dobb’s Journal, February 1984 


nds for the mainframe to process, 
ou can tell immediately if you geta 


then backspace over it and retype it. 
en large amounts of data are being 


yrs, Such as checksums or cyclic © 
lundancy checks. The next question 


Mainframes 


If you want to send files to a main- 
frame, or a minicomputer other than a 
DEC, then XMODEM will not help you. 
These machines just do not speak the cor- 
rect protocol. Our solutions now are to 
change the protocol to one the main- 
frame understands, or implement one we 
know on the mainframe. Larry Hughes 
has a Fortran program which can be in- 
stalled on a micro, mainframe, or mini to 
talk to his MITE package. He will send 
you a copy free if you ask for it when 
ordering MITE. This is a pretty good deal 
since it lets you talk to many machines 
for which no other simple solution is 
available. However, this gives you fairly 
slow communications — not very good 
for moving large amounts of data. Where 
are we to find a really good solution for 
micro-to-mainframe communications? 


things may be eae accurate, depending 
on the method used and the context in 
which the error occurs. Any simple 


calculation of the accuracy of these 


ae -checking methods assumes that: 


(1) There are about the same 
number of ones as zeroes in the data. 
The mathematics becomes much worse 
but the probability of detecting the 


error improves if this assumption is 
not true. 





(2) The changes are independent 
of each other. This is not true — be- 
cause phone line noise occurs in bursts, 


the fact that bit n was clobbered greatly : 


increases the probability that bit n+1 


will be clobbered also. My friend feels _ 


that this will not affect the result, par- 
ticularly if assumption (1) is true. If 
assumption (1) is false and the changes 
are dependent, the math really gets 
hairy. _ 

(3) There is an equal probability 
of changes in each direction. That is, 
saying that bit n was clobbered means 
the receiving system will see a one bit 
exactly half the time. This assumption 
should be true of noise, but may not 
be true of hardware faults. If it is false, 
the probability of detecting the error 
increases, but it is very difficult to say 
by how much. 

After all of those caveats, if we 
assume that, on the average, ten bits 
get hit in anyp particular bad block, then 
the probability of missing an error is 
between one in 142 and one in 147. 
The longitudinal redundancy check 
misses approximately one error in 142. 
My friend was able to calculate this 
mathematically, but the math involved 
with the two addition methods was so 
complex that a Monte Carlo simulation 
was set up to estimate the accuracies. 


check code. This eee : 
on ‘the hoot end to 
errors. 


(2200. If we again assume that 


: becomes even smaller. 


_3McNamara. 


I mentioned earlier that many main- 
frames use protocols that were developed 
long before XMODEM was around. Some 
of these protocols show their age; X- 
MODEM is better by far. Others were 
pretty well designed and offer capabilities 
and performance well beyond anything 
XMODEM is capable of. The mainframe 
protocols normally use a cyclic redundan- 
cy check (CRC) rather than a checksum; 
this gives much greater confidence in the 
accuracy of the received data. 


Most of the common protocols allow 
blocks of data to be any number of bytes 
(or even any number of bits) long. This is 
more efficient than fixed block sizes, but 
introduces other problems. For example, 
because the block can be of any length, 
the protocol must either transmit the 
length in advance or mark the end of the 
block in some way. If the end of the 





If the 8- bit Ghechaae | is spate ch by | 
the simple addition of data bytes, 
modulo 256, approximately one error 
in 147 will be missed. Our confide 
factor here was roughly 95 perce 
When the carry is added back int th 
























accurate! This is acceptable fo 
critical applications. 
The cyclic redundan 
better error checking me 
the checksum. The mathem 
quite interesting; they are base 
treating the message as a huge in 
The message is then (for a standard | 
CRC-16) multiplied by 21° and then © 
divided by 1100000000000010: e 
generator polynomial, 17 bi 
The 16-bit remainder is the 
to the end of a message a 





“The standard CRC- 16 (si 
CRC) will detect all errors of 1 
or less, and 99.955 percent 0 
errors” of more than 16 bits.” 
means that in the worst case ( 
than 16 bits in error) we wi 
detect the error only one time o o 





average only ten bits are cha: 
probability of not detecting 
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block is marked, then this special end-of- 
block character must not appear in the 
data. This problem is usually solved by 
defining a transparent mode, in which the 
data is altered to remove any special 
characters before it is transmitted. For 
example, in HASP a DLE (Data Link Es- 
cape) character in the data would become 
DLE DLE, and the receiving station 
would throw away the first DLE. The 
common mainframe protocols are not 
simple! 

These protocols usually require 
synchronous modems, and 2000 baud is 
the slowest speed commonly available — 
4800 baud is very common, and 9600 


baud is not unusual. If you really need to 
move a lot of data, this is the way to go. 
This approach is not cost-competitive 
with XMODEM or MITE, but it offers 
tremendous performance and easy entry 
to mainframe environments where the 
other packages are not available. 


2780/3780 


A typical mainframe protocol would 
be 2780/3780, an IBM protocol developed 
many years ago and now in widespread 
use by many other companies. It is availa- 
ble on virtually every mini and mainframe 
in existence. At 2000 baud, XMODEM’s 
128-byte blocks would take only half a 
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second to transmit, so 2780/3780 allows 
for larger blocks. The larger blocks give 
much better line utilization, particularly 
at higher baud rates. However, 2780/3780 
is not a simple protocol; it requires larger 
buffers than XMODEM (and uses much 
more memory overall). There are also 
plenty of places where the implementor 
can make mistakes. Still, it is a good pro- 
tocol and very useful for moving large 
volumes of data around. It is primarily 
designed for remote batch stations and 
for moving data, not for interaction. The 
major disadvantage of this protocol is 
that only one thing can be happening at 
any given time. For example, the user can 
be printing a file from the mainframe, but 
cannot be downloading a file to disk at 
the same time. 


HASP 


HASP is another IBM protocol; it is 
very nearly a superset of 2780/3780. It is 
widely available on mainframes and minis 
of all types. HASP provides capabilities 
that are really incredible (the protocol 
defines seven printers, all of which can be 
going at once!). HASP also compresses 
data before it is sent, increasing the effec- 
tive transmission speed. A good imple- 
mentation of HASP will eat 48K of RAM 
in an instant, and one could easily use 
64K or even more (if it allows large buf- 
fers, is fully menu driven, has on-line 
help, etc.). Most implementations on 
micros leave off a few things — like five 
or six of the seven printers. (When was 
the last time you had the need to run 
three printers simultaneously from your 
micro? ) 

HASP is also very complex, and there 
are many places to make mistakes. Again, 
a top quality implementation will antici- 
pate and correct for mistakes in the other 
machine. I helped develop a package 
called HASTE for the computing center 
where I work and I know that the other 
implementations do make mistakes some- 
times. In some cases (not all) clever pro- 
gramming on the micro end will correct 
faults on the mainframe end. For exam- 
ple, HASP compresses data before it 
sends it; in theory a single 400-character 
block (a common size) could expand into 
16K of actual data! Needless to say, if 
you try to expand the received data in 
memory, you can get yourself into real 
trouble. HASTE expands the data only 
when it reaches its ultimate destination — 
the console, the printer, or disk. We have 
seen a mainframe implementation, how- 
ever, which tries to do it in memory — we 
know because we blew it out of the water 
with a large compressed block! 

HASP also defines control bits to 
control the different data streams (one 
stream for each of the seven printers, plus 
console, card reader, and card punch). 
These control bits may be transmitted 
with any block of data or as a separate 





message if there is no data to send. Thus 
when the micro’s printer buffer fills up, 
we send out the FCS bits saying, “You 
can’t send me any more printer data.” 
Later, when the buffer empties, we send 
another message saying, ‘“‘Printer stream 
one is now available again — send more 
data.’’ If the micro receives a NAK (nega- 
tive acknowledge) it must retransmit its 
last block. 

What is not clear from the documen- 
tation is whether the retransmitted block 
should contain the previous FCS bits or 
the current FCS bits. If we send the pre- 
vious FCS bits (saying ‘“‘Send more data’’), 
but our buffer is now full and the main- 
frame believes that FCS bits are always 
correct, then it will send data that we 
have no room for. If we send the current 
FCS bits, and the mainframe believes that 
FCS bits stay with the block (i.e., may 
not be current), then it will not act on 
FCS bits sent with a retransmitted block 
(they may be out of date). This means 
that we can send FCS bits saying, “‘Send 
me more data,” and the mainframe will 
ignore them. We will then wait forever for 
the mainframe to send more data. The 
solution to this is to treat the FCS bits 
as always current, and retransmit them 
until they eventually go out on a block 
that is not itself being retransmitted. This 
will work with either implementation on 
the mainframe. Not every implementa- 
tion (micro or mainframe) concerns itself 
with little details like this! 

To give you a feel for the speed of a 
protocol (and package) like this, I recently 
downloaded 4.5 megabytes of data from 
our mainframe to the hard disk on a 
Kaypro 10. Using a 2000 baud modem 
it took just five hours. 

HASP is again designed more for 
moving data than for interaction, but it 
allows concurrent operations. A single 
user can in theory be printing a file from 
the mainframe, sending the mainframe a 
file from disk, receiving some data and 
storing it on disk, and typing in some 
commands for the mainframe, all at the 
same time! Not all implementations will 
support this in the same way, but most 
provide at least some of these capabilities. 
HASP makes for a wonderful (although 
expensive) micro-to-micro file transfer 
environment. Because of the multi-stream 
capability you can type messages to your 
friend on the other end of the line at the 
same time that you are sending him or 
her the latest copy of the new utility you 
are working on. No more need fora second 
phone line or hanging up and redialing. 


3270 

As a last example of a popular proto- 
col, 3270 is yet another IBM protocol 
that sees wide use. It is, however, not 
widely used outside of IBM sites. This 
protocol is designed for interactive work 
at a terminal; it thinks in screens. It is 
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synchronous like HASP and 2780/3780, 
and can be either bit or byte oriented. 
HASP and 2780/3780 deal strictly with 
bytes — 3270 can transmit three bits as 
easily as eight. This protocol is not used 
much for moving data between systems, 
primarily because that is not what it does 
best. The 3270 protocol contains informa- 
tion on cursor positioning, screen clear, 
and other terminal-related things. 


Conclusions 


Communications is a very large, very 
deep swamp, and it contains many alliga- 
tors. If you jump in with no preparation, 
you will get eaten alive. However, with a 
bit of thought toward what you wish to 
achieve, you can get through it success- 
fully. 

If cost is of utmost importance, look 
at XMODEM. If you have any sort of 
common micro, XMODEM is probably 
already available for it for free. 

If you need to talk to a single mini or 
mainframe, and need to move moderate 
(less than 500K characters per week) 
amounts of data, take a good look at 
XCHANGE11, MITE and its Fortran 
friend, or some of the other similar pack- 
ages which are available. 

If you need to move large amounts 
of data, or need to talk to several different 
mainframes or minis, investigate the HASP 
and 2780/3780 synchronous packages. 
These are more expensive initially, but 
pay for themselves with their tremendous 
performance. 

If you need to interact with an IBM 
mainframe, but don’t need to move much 
data, look into 3270. 

As with everything else, there are 
good packages available and also some 
very poor ones; investigate before you 
buy. 

I have waved my hands over some of 
the details and completely ignored others, 
but I hope that overall this has given you 
a pretty good introduction to communi- 
cations. If you now know the proper ques- 
tions to ask and can tell when someone is 
trying to snow you (or just doesn’t know 
the answer) then J will have accomplished 
everything I could reasonably hope for. I 
have no relationship to any of the com- 
panies or products mentioned, except for 
HASTE which I helped develop. BB 
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Unix-to-Unix Network Utilities 





known yet powerful set of asyn- 
chronous Unix-to-Unix network 
utilities initially developed for internal 
use at Bell Labs and now available on 
most of today’s Unix micro machines. 
These network utilities provide per- 
haps the most standard (if not the sim- 
plest) method to move files and programs 
from one Unix machine to another. More 
importantly, a manageable and inexpen- 
sive network can be created to perform a 
variety of chores such as remote spooling, 
central filing and backup, remote data 
collection, electronic mail, and so on. 
There are two basic utilities: uucp 
and uux. Uucp (Unix-to-Unix copy) is 
intended to work much like the Unix file 
copy utility, cp. The only difference is 
that the source and destination files also 
include the name of a Unix system on 
the network. The uucp syntax is: 


7 his article examines a relatively un- 


uucp [-options] sys1!src sys2!dst 


such that sre and dst are source and des- 

tination filenames, and sys1 and sys2 are 

the designated machines on which the file 

. exists or to which the file is copied. The 

entity in the square brackets is optional. 
For example, the command 


uucp A! file1B!file2 


will copy filel on machine A to file2 on 
machine B. 

Uux (Unix-to-Unix execution) al- 
lows commands to be initiated on the 
local machine and executed remotely on 
another machine. A request to execute a 
command is sent to the remote machine, 
and if the request can be honored (i.e., 
the program exists on the remote Unix 
machine and is executable), the remote 
machine will try to execute the command. 

The uux syntax is: 


uucp A!file 1 B!file2 


emd2 | uux-sys1!cmd1 [sys2!files] 

Or 
uux-sys1!cmd1[sys2! files] < [sys3! ] file 
In the first case, uux will execute the 
command cmd on the system sys] and, if 
necessary, will first copy the required 
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files from system sys2 to system sysl to 
be available to cmd on its command line. 
The next two cases are much the same 
except that uux’s standard input is redi- 
rected to come from a Unix pipe (the 
second case) or a file (the third case); the 
rest of the arguments function the same 
as in the first case. Note again that the en- 
tities in the square brackets are optional. 

The important thing to note about 
the last two cases is that uux’s standard 
input is copied to the remote machine 
sys2 along with the request to execute 
cmd1. Once on the remote machine, cmd1 
and its command line are reconstructed 
for proper execution. 

The Unix-to-Unix network utilities 
include a number of other utilities that 
perform, among other things, the actual 
machine-to-machine communications 
(protocols, handshakes, log-in proce- 
dures) and the actual remote machine 
execution of the requested commands. 
Uucico (Unix-to-Unix copy-in copy- 
out) and uuxqt (Unix-to-Unix execute), 
respectively, perform these chores—typ- 
ically in the background. 

Each time a uucp or uux command is 
issued, a group of special ‘“‘work’’ files is 
queued in a spool directory, and uucico is 
run in the background to process these 
files. The ‘‘work’’ files contain all kinds 
of information about which files are to be 
copied and to where, how the files should 
be copied, and how to execute the re- 
quested command. Since uucico is run in 
the background, the user does not need 
to wait until the actual work is com- 
pleted before receiving control of the 
Unix shell again. As uucico works, it 
posts status checkpoints in a log file. 

After finding a work request and 
checking permission for the request, 
uucico attempts to log on the remote 
machine. The entire log-in procedure is 
user-defined when the uucp system is 
first configured and can be tailored to per- 
form almost any dial-out/log-in sequence. 

If the Unix log-in prompt is suc- 
cessfully reached, uucico logs on the 
remote machine as a user named ‘“‘uucp.” 
Logging in as “‘uucp” causes the remote 
machine to execute a uucp command, 
which in turn forks a uucico command 
in “‘slave’’ mode; the uucico process that 
made the call to the remote machine runs 
as a “‘master.”’ The slave process initiates 
the handshake and the master acknowl- 
edges. They agree upon a protocol and 
the master begins sending requests. 

After the master has exhausted its 


requests, the uucico roles are switched— 
the master becomes the slave and the 
slave becomes the master. If the called 
machine has work bound for the calling 
machine, the new master sends its re- 
quests to the new slave. This continues 
until neither machine has any more work, 
at which point they hang up. 

Since Lehman Brothers has several 
in-house Unix machines, we felt that 
with uucp and uux we could take these 
off-the-shelf utilities and build a net- 
work. Our first application was to create 
a printing network (using primarily uux) 
in which any user on any machine could 
access any printer on any machine. 

Building a network was not as easy 
as it sounds because: (1) we wanted the 
existence of the uux utility to be com- 
pletely transparent; (2) we wanted the 
print command interface to be consistent; 
and most difficult of all (3) we wanted 
the uux command to work unattended 
even in the face of such things as log-in 
failures, locked devices, and a few minor 
but potentially crippling uucico bugs that 
are easily handled manually. 

The first and second goals were met 
by constructing a virtual printer. This is 
a channel through which the print data is 
piped to a uux process; uux then routes 
the data to the target machine. 

Achieving the third goal took much 
more effort. Since uucico runs in batch 
fashion, the user cannot interactively 
assist uucico during the processing of the 
work files and log-in procedures. Some 
problems can be anticipated, but if the 
log-in fails, uucico simply records the 
failure in the log file and dies; the user 
receives no message and may never know 
if the request was fulfilled. Moreover, 
once the log-in fails, uucico locks all calls 
to the remote machine for about an hour. 
Another attempt to fulfill the request is 
not possible until uucico is restarted 
manually or until uucp or uux is issued 
again—after the hour of lockout time. 

Worst yet, uucico sometimes dies for 
no apparent reason, even though the 
log-in was successful! When this happens, 
uucico fails to reset the permissions on 
the /dev/tty files and the spool directory 
(/usr/spool/uucp). 


To resolve these problems, we first 
carefully chose a log-in sequence that has 
about a 7 to 10 percent failure rate. Next, 
we wrote a daemon that wakes up when- 
ever files are being spooled remotely. This 
small program can reset the permissions 
on the /dev/tty files and spool directory 
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and knows how and when to remove the 
lock files and automatically restart uucico. 

Figure 1 (below) illustrates this net- 
work. The user sees only Lp1, Lp2, Lp3, 
and Lp4. If a user sends a request to a lo- 
cal printer on his machine, the request is 
honored directly. Whenever a printer is 
specified that is not on the local ma- 


chine, a special preprocessor shell script 
adds one line of routing data to the be- 
ginning of the input file, and the request 
is given to the virtual printer. The virtual 
printer reads the first line of the modified 
input stream and integrates that line in a 
uux command string. The actual print 
data is then piped to the uux process that 


uses the routing string to direct the print 
request to the remote machine. Although 
a remote print request has yet to fail, we 
estimate the average failure rate to be 
about 3 to 5 percent. BB 


Reader Ballot 
Vote for your favorite feature/article. 
Circle Reader Service No. 194. 


Unix Machine A 


Unix MachineB | 


— - Physical Printer | 


| 
| { Lp6 } Virtual Printer 
Lp1 or Lp3 e. . 
NS. U7 


/ 


_ Figure 1. 
Unix-to- Unix Network: 
Physical/Virtual Printer Relationship 


























—. Ise ; 
COMPUTER # TECHNOLOGY 





¢« Speed ¢ Communications 

¢ Hardware Floating ¢ Data Acquisition 
Point ¢« Upgradeable 

- Device Control - Idris / MODULA-2 / 


¢ Conformant with CP/M 68k 
Apple, IBM, and other +» 40 Mb Winchester 
p-system software 





Before | began writing software for a living | was a research 
chemist. | collected lab data here and there, and | know 
how much faster some things are with the right computer 
system. And how frustrating it is with almost the right 
system. 


| expect a good system to have speed, documentation, 
ability to reach out and tweak things, and remember a lot of 
raw data. Oh, and of course, to do word processing since | 
... well, wasn’t an English major. 


| have used SAGE personally, and one of our flagship 
customers actually purchased our loaner SAGE rather than 
use the IBM machine sitting next to it. Like he was really 
happy with SAGE, and | don’t remember him being really 
happy with any machine before. 


If you are looking for a computer, | recommend that you 
consider SAGE. 


Aubrey Mcintosh, President 
VIMA, Inc. 

P.O. Box 6181 

Madison, WI 53716-0181 
608-221-4447 


Circle no. 82 on reader service card. 


Dr. Dobb’s Journal, February 1984 





BUILDING 
BLOCKS 


Save a year of development. 







































0 IBM PC* Building Blocks ....................... cee cece eee 
Video & IO routines, string functions, asynchronous port control. 
Over 100 functions. 


(-Miathematics Library. -\. 5.205. sh eee $ 99 
Logarithms, trigonometric functions, square root, random numbers. 
0 Text Display Windows Library .............................65 aa 
Multiple windows/independent text and attribute display. 

OC Cross-reference Utility ................. cc ccc eee c cece ee eeees $ 99 
Cross-reference identifiers and functions. 

O Communications Library ........................... cece eee es $150 


For Hayes Smartmodem?, modem 7 and xmodem. 


O Graphic Functions Library .........................cceeeeeees $ 99 
Rectangles, arcs, lines, points, text, NAPLPS functions. 

O B-trees & Virtual Memory Management Library ........ $125 
Ci Reet EAR Gs. see en senate eee ae $ 99 
CO) extent Analysis Library.-)) 002.25. eeu $125 
O Data Compression Library .............................00.2005- $ 99 
Ci Fie-series LIGVary ©... 33..ee cea $ 99 
0 Calendar Date Arithmetic Library ........................... $ 99 
Ci dRaseli~ Access Library. 3.2.2.5... sae ee $ 99 


All Building Blocks use the ‘IBM PC Building Blocks’. 


Source Included. Credit Cards Accepted. Single User License. 
Multiuser licenses available. 


NOVUM 
ORGANUM 


29 Egerton Road, Arlington, MA 02174 Telephone (617) 641-1650 


(TM) IBM* 








(TM) Hayes Microcomputer Products (TM) Ashton-Tate* 






Circle no. 50 on reader service card. 


31 





Virtual Personal Computer 





project is an effort to develop a gen- 

eral architecture and specification 
for a personal computer that can be 
integrated with networks and larger com- 
puter systems. This article concentrates 
on the overall philosophies and architec- 
ture of the VPC. 

The primary goal of the VPC project 
is to integrate personal computing and 
time-sharing. Time-sharing systems and 
personal computer systems have been 
based on fundamentally different philoso- 
phies. The Unix time-sharing system was 
designed to support a large number of 
dumb, full-duplex terminals. Typical Unix 
users are accustomed to the normal delays 
and slow communication links associated 
with such systems. Personal computers, 
on the other hand, have been designed as 
dedicated nontime-shared systems offer- 
ing users unbelievable real-time response. 
Personal computer users that have never 
used a time-sharing system are being 
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spoiled by this 
capability. 

Software developed for time-sharing 
systems may be incompatible with per- 
sonal computers and vice versa. As an 
example, in the Unix time-sharing system 
the concept of blocked I/O is used exten- 
sively. When a process wants to read 
information from a user’s terminal, it 
issues a read system call. If the user has 
not typed any information, the process 
becomes blocked. The process will wait 
indefinitely until input is generated. 
While the process is blocked waiting for 
terminal input, it is not allowed to do any 
computation or read any other I/O de- 
vices. This blocking frees the main 
processor, which allows other users to 
Share the same processor (thus, the term 
time-sharing). 

Personal computer software is often 
designed without the concept of blocking. 
Instead, if input is desired from a user ter- 
minal, a check is done first to see if input 
is available. If input is available, a read is 
requested. The read system call returns 
immediately with the information with- 
out blocking because the check had indi- 
cated that data was available. If no data is 
available, another check can be made, and 
the user program will loop indefinitely 


dedicated processing 
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waiting for inputs. If other I/O sources 
need to be serviced, the user program can 
check these multiple sources and read any 
that have data waiting. Keyboard input can 
be checked, a printer can be controlled, 
and a communication link can be serviced 
with precision under control of a user 
program. 

As time-sharing and personal com- 
puter environments begin to converge, we 
must be aware that an indiscriminate merg- 
ing of techniques from each environment 
may not yield an optimum situation. 

The goal of the VPC project is to 
integrate the best of personal computing 
with the best of time-sharing. The VPC 
handles all local real-time-sensitive activi- 
ties to give the user instant feedback. Pro- 
grams running on the VPC are designed 
like classic personal computer programs 
with the check/read looping methods. 
Because it is assumed that a dedicated 
processor is available in the VPC, no con- 
cern is given to the processor cycles 
wasted using this methodology. 

The application programs resident on 
the host system, however, are designed 
using the normal time-sharing blocked 
I/O techniques. Messages are exchanged 
between the VPC and the host at a rate 
compatible with these methods. 
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In systems like Unix, no change 
needs to be made to the application pro- 
grams. The functions normally performed 
by the device drivers are ““remoted”’ to 
the VPC. A simple change to the existing 
Unix device driver (which reduces its size) 
makes the VPC transparent to the appli- 
cation. The user is also unaware that 
functionality has been moved from the 
host into the VPC. High-speed real-time 
response is now possible so that personal 
computer users are not penalized by inte- 
grating their system with a time-sharing 
system. 


Basic VPC Architecture 


The basic VPC architecture is shown 
in Figure 1 (page 32). A process(or) is 
connected to the host system via a bi- 
directional 16-bit data path and a 5-bit 
control path. The 16-bit data path is 
called the remote I/O channel, and the 
5-bit control path is called the remote 
control channel. The process(or) is inter- 
faced to the user by another 16-bit bi- 
directional data path called the local I/O 
channel. 

The process(or) is a 16-bit machine 
that executes one program residing in a 
64K address space. The process(or) can 
be controlled by the host via the remote 
control channel. The process(or) can send 
and receive data to the host or user over 
the respective I/O channels. Local disk 
storage is supported using a hierarchical 
file-naming structure. An interval timer 
and time of day clock are also supported. 

Character-oriented peripherals are 
connected to the local I/O channel. The 
upper eight bits of the local I/O channel 
are decoded as a device address, and the 
lower eight bits carry data to and from the 
device. Many protocols can be supported 
by these character-oriented peripherals. 

The architecture of the VPC is based 
on the layered approach used in many 
data communication systems. Layering 
allows various parts of a system to be 
specified independently of the other parts. 
Changes can be made in a layered system 
with the confidence that the entire archi- 
tecture will not fall apart. 

Four distinct layers are evident in the 
VPC architecture. The four layers can be 
seen in Figure 1 by imagining that vertical 
lines separate the major boxes. Working 
from right to left, one can see the link lay- 
er, the multiplexer layer, the process(or) 
layer, and the user layer. 


The Link Layer — 
7-Bit, Asynchronous, Even Parity Version 


The primary purpose of the link layer 
of a VPC is to guarantee that 8-bit bytes 
can be transferred in both directions in an 
error free (or error unlikely) manner. A 
variety of link layer configurations can be 
developed. Only the asynchronous parity- 
checked configuration will be discussed 
here because this is commonly used on 
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personal computer systems. 

In Figure 1, the link layer consists of 
the boxes C78 and C87 plus the hardware 
necessary to transmit and receive data to 
and from the host. In a 7-bit, even parity, 
asynchronous transmission system, a 
UART and modem are usually used as the 
primary hardware components. In this 
type of system, only seven data bits can 
be passed across the link. The software 
modules (C78 and C87) are used to con- 
vert one or more 7-bit data items into an 
8-bit byte. The 8-bit bytes are used to 
interface the link layer with the multi- 
plexer layer. 

Many schemes have been devised to 
convert 8-bit bytes to other forms for 
transmission through 7-bit channels. The 
most common technique is to split each 
8-bit byte into two 4-bit nibbles and 
send each nibble as an ASCII character 
from the set (0-9, A-F). This method 
works fine but doubles the amount of 
transmission. A 4000-byte file requires 
8000 bytes of transmission. 

Other methods block multiple 8-bit 
quantities together and enclose the packet 
between a header and a trailer. The data 
(the 8-bit quantities) are wrapped inside 
the packet and flow through the channel 
in a semi-transparent manner. Blocking 
does not help the problem of pushing 8- 
bit packets through 7-bit channels. Block- 
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ing can also be inefficient when many 
small data messages are sent because of 
the header and trailer overhead. 

The filters shown in Figure 1 have 
been designed to push 8-bit bytes through 
7-bit channels without the need for 
blocking and without interfering with 
control codes commonly used for flow 
control (e.g., XON, XOFF). The C87 
filter (see Listing One, page 46) can be 
used to convert any 8-bit stream into a 
7-bit stream. The C78 filter (see Listing 
Two, page 50) will convert the 7-bit 
stream back to 8-bit format. Each of the 
filters reads the standard input and writes 
on the standard output and can therefore 
be integrated with other Unix tools. 

The filters operate by starting with 
the assumption that only 96 codes (32- 
127) are available for data. The lower 32 
are assumed to be control codes, and the 
upper 128 are lost to the parity bit (nor- 
mally even). The 96 codes are split into 
two parts. The codes 32-39 are used to 
encode one of eight base addresses. The 
eight base addresses are all offset by eight 
to account for the common occurrence of 
ASCII data in the channel. The offset of 
eight is assumed by both filters and not 
sent through the channel. The codes 
40-127 are used to encode an offset from 
the base address. 

The base address is changed only when 
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a code cannot be reached by the offset. If 
the base address has to be changed, one 
7-bit data item is sent to change the base 
address, and one 7-bit data item is sent 
with the proper offset. If the base address 
does not have to be changed, then one 7- 
bit data item is sent with the offset. As 
long as the base address does not have to 
be changed, each 8-bit byte is encoded as 
one 7-bit data item. In normal practice 
one finds that ASCII text grows by about 
25-30 percent and object modules grow 
by about 30-35 percent. 

These filters are used to form the 
link layer processing in the VPC. The C87 
filter processes incoming data, and the 
C78 filter processes the outgoing data. 
The normal Unix device drivers handle all 
flow control and do not interfere with 
data because the control codes are avoided. 
The 8-bit data emerging from the C78 
filter are sent to the multiplexer and 
further decoded. When the multiplexer is 
ready to send an 8-bit value to the host, 
the C87 filter processes the byte. All data 
values (0-255) can be sent through this 
layer using these filters. 

It should be noted that this link layer 
method is able to detect some errors in 
the transmission channel but is not able 
to correct any errors. This method can be 
used when a VPC is connected to a host 
via a hard-wired connection ora low-speed 
modem. 
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Future versions of the VPC will fea- 
ture different link layer arrangements. 
Link layer methods for blocked asynchro- 
nous and synchronous transmission are 
being developed. These methods allow 
for error detection and correction via re- 
transmission. They guarantee an almost 
100 percent error free transmission. This 
change to the link layer will not impact 
other parts of the system. 

Another item of note concerning the 
link layer is that, when a VPC is run 
resident on a single Unix system, no link 
layer processing is needed. The VPC mul- 
tiplexer layer is connected via Unix pipes 
to the host multiplexer layer. Unix pipes 
are able to pass 8-bit bytes in an error 
free manner from one process te another. 

As can be seen, a lot of options are 
possible in the link layer portion of the 
VPC architecture. Because of the layered 
design approach, changes in the link layer 
do not affect the other layers. In fact, in 
most sophisticated networked systems 
the link layer can be replaced by existing 
low-level transmission methods. If a sys- 
tem already supports X.25, ETHERNET, 
or another proprietary protocol, the link 
layer function of the VPC can be per- 
formed by the resident transport mecha- 
nism. The only function that the link 
layer performs is to provide an 8 -bit error 
free path with flow control. If this can be 
provided in another manner, one is free 
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to use that method. The other layers of 
the VPC are not affected. 


The Multiplexer Layer 


The multiplexer layer is the heart of 
the VPC-to-host interface. The sole 
purpose of the multiplexer layer is to en- 
code the 16-bit data from the remote 
FIFO and the 5-bit data from the remote 
FIFO (discussed at greater length in the 
next section) and the 5-bit data from the 
remote control channel into 8-bit bytes. 
These 8-bit bytes make up the interface 
to the link layer. The multiplexer encod- 
ing scheme is extremely simple and is 
shown in Figure 2 (below). 

When a OXXXXXXX (0-127) code 
appears on the 8-bit channel, the lower 
seven bits are added toa previously loaded 
11-bit register, producing a 16-bit result 
(see Listings Three and Four, pages 38 
and 39 respectively, and the discussion on 
Levels of VPC, page 44). The 11-bit regis- 
ter is padded with five zeroes (on the 
right) before the addition is performed. 
The 2-bit overlap between the two 
values means that the 7-bit code is ac- 
tually a positive displacement from a 
base that is always a multiple of 32. The 
7-bit code can actually reach 128 values 
from a given 11-bit base. The 11-bit base 
is changed only if this 128 position win- 
dow is exceeded. 

Initially OOOOO0000000, the 11-bit 
base can be changed using 1OXXXXXX 
or 110OXXXXX. The middle 6 bits of the 
11-bit base register are loaded when a 
10OXXXXXX (128-191) is received. The 
upper five bits of the base register are 
loaded when a 110XXXXX (192-223) is 
received. No data are produced when 
either type of code is received; the 11-bit 
base register is changed and saved for 
future use. All multiplexers should initial- 
ize the 11-bit base register to ensure that 
a known state is set when the link is 
established. The default value at start-up 
is 00000000000. 

The codes 111XXXXX (224-255) 
are used for a 5-bit control channel. The 
32 codes that form the control channel 
are divided into 16 opcodes (1110XXXX 
224-239) and 16 data values (1111X XXX 
240-255). 

The end result of the multiplexer 
function is to create the illusion that a 16- 
bit bidirectional data path and 5-bit bi- 
directional control path connect the VPC 
and the host. If one desires to build this 
arrangement using ribbon cables and large 
connectors, the multiplexer can be re- 
moved. The other parts of the system are 
not impacted except that things may run 
a little faster. 

The 16-bit data path is used for all 
data traffic between the VPC and the 
host. No subchannels are assumed, and 
any 16-bit value can be sent through the 
channel. Subchannels can be created by 


Dr. Dobb’s Journal, February 1984 


Don’t call her cheap. Call her beautiful. 


The Bonnie Blue’ 


Word Processing System for the IBM Personal Computer 


It’s obvious what makes her so cheap, but what makes 
Bonnie Blue so beautiful? Bonnie Blue is a new and easy-to-use 
word processing program for the IBM Personal Computer. 


The Full System. The Bonnie Blue System includes in one 
program a full screen Editor, a Printing module and a useful 
Toolbox. It includes the features you've come to expect, and 
more: 


complete cursor control: by character, word, line; page up and 
down instantly; go to top, bottom of document; auto scroll 
towards top or bottom 

word wrap 

margin justification, centering 

adjustable margins, tabs, indents 

reformat paragraphs 

move, copy, delete, paste blocks 

find with delete, insert, replace and wild card characters 

keyboard remapping 

multi-line headers, footers 


Bonnie Blue can handle lines longer than the screen is wide, 
by horizontally scrolling the line. And, unlike some programs, 
Bonnie Blue lets you include any displayable character in your 
text, such as block graphics and foreign language characters. 


Unique Features. With Bonnie Blue, you can “paint” 
display attributes onto your text, by the character, word, or 
line, or automatically as you enter text. With the monochrome 
adapter, you can paint any combination of underlined, bold, 
reverse video or blinking. With an 80 column monitor and the 
color/graphics adapter, this translates into a palette of 16 color 
combinations to choose from. And if your computer has both 
monitors, Bonnie Blue lets you use them both, shifting back 
and forth as you wish. 


IBM Personal Computer is a trademark of |BMCorp. Epson Graftrax Plus is a trademark of Epson America Inc. 


Bonnie Blue Software resents 


[1 Send me the Bonnie Blue System. | am 
enclosing $50 (NY State residents please 
add 7% sales tax). 


[] Checkenclosed © VISA () MasterCard Sorry,noCOD. 








[] Please send literature. 
lhavea 


Powerful Printing Module. You can use these colors or 
display attributes to highlight text on the screen, and Bonnie 
Blue can remove them from a file when you want (all files 
created by Bonnie Blue are DOS standard). The Printing 
module understands these text attributes, and you can map 
them into any single printer function or combination. 

For example, normally you would want underlined text to 
print underlined. But you can tell Bonnie Blue to print 
underlined characters as both underlined and bold. Bright text 
onthe screen can mean double struck, or emphasized and in 
italics. You are at the controls. 

The first Print formatting module supports all the text 
capabilities of the Epson MX series with Graftrax Plus. By the 
time this ad appears, we will be supporting other popular 
dot-matrix and letter quality printers. 

More than thirty “dot” commands give you added control of 
the format of your finished document. You can send it to a disk 
file instead of the printer, or preview the final page formatting 
on the screen. 


Toolbox. The Toolbox is a set of useful functions, called 
“filters” that allow you to extract information from your files 
and transform their content. With these tools, you can join 
files together, sort lines of text, count words, find and 
substitute patterns, etc. Writers and programmers find this a 
useful collection of productivity enhancers. 


Bonnie Blue is also great for a hard disk system. A thorough 
User’s Guide, complemented by help screens and roadmaps, 
make the Bonnie Blue an exceptionally easy-to-learn and 
easy-to-use system. 

Order yours today, or send for our free brochure. Bonnie 
Blue is available exclusively from Bonnie Blue Software, 
P.O. Box 536, Livernool, NY 13088. 





Minimum 
recommended system: 











ires_ 
Ne pes IBM PC, 128K, 2 disk drives, 
Signature PC-DOS 1.1 or 2.0, 80-column 
monitor or monochrome adapter, 
Name ater or both, Epson MX-80 or 
Address te a MX-100 with Graftrax Plus. 
City State es. Ae 





Company___———————————————————— 





Versions available soon for PCjr. 
Write for details. 





184 


Circle no. 6 on reader service card. 





conventions established for various appli- 
cations. 

A typical arrangement is to use the 
upper eight bits of the channel as a sub- 
channel number and use the lower eight 
bits for data. This arrangement yields 256 
independent 8-bit channels from the host 
to the VPC. The VPC may use a dozen of 
these channels for video windows, a couple 
for printers, and a couple for keyboards, 
and save the other 200 for future use. In 
noninteractive applications, 256 pipes can 
be established between the VPC and the 
host. This should be sufficient for most 
applications. 

Another arrangement might be to 
use some of the high-order bits (five is a 
nice number) as a subchannel number 
and the other (three if five is used ) high- 
order bits as subchannel data type indica- 
tors. For example, subchannel types for 
control and data could be determined by 
the type bits. With this arrangement, data 
arriving at the host can be classified as 
data or control and routed to the proper 
process or driver. Priorities can also be 
encoded in the upper bits so that channels 
can be handled with the proper urgency 
in the host. In all of these arrangements, 
eight free data bits are available in the 
low bits for total compatibility with exist- 
ing systems. 

The important thing to remember 
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about the multiplexer is that its only job 
is to multiplex the 21 bits (16 data, 5 
control) of information needed by the 
VPC process(or) into 8-bit bytes. No 
Special assumptions are made about the 
16 bits of data that flow through the 
multiplexer. Since the host has the ability 
to reconfigure the VPC process(or) via 
the 5-bit control channel, application- 
specific conventions can be established 
without impacting the multiplexer. 


The VPC Process (or) Layer 


The VPC process(or) layer interfaces 
to the multiplexer layer and the user lay- 
er via buffers called FIFOs (First In First 
Out). As the name implies, these 16-bit 
wide buffers are loaded and unloaded in 
the same order. 

The remote FIFO interfaces the VPC 
process(or) to the multiplexer layer. Data 
written into the remote FIFO are eventu- 
ally processed by the multiplexer and 
sent to the host. Data received from the 
host on the 16-bit multiplexer data chan- 
nel are loaded into the remote FIFO and 
become available to the VPC process(or). 
The remote FIFO is bidirectional, and the 
data for each direction are kept indepen- 
dent of the other direction. 

A similar arrangement exists for the 
local FIFO, which interfaces the VPC 
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process(or) to the user layer. The user 
layer contains various device driver soft- 
ware modules and peripherals that inter- 
face with the user. The VPC process(or) 
can send and receive information to and 
from the user via the local FIFO. 

The VPC process(or) is a classic 16- 
bit processor with 64K of data space. 
Program execution normally begins at 
location 0. The VPC process(or) contains 
a program counter, stack pointer, stack 
frame pointer, argument pointer, and 
literal pool pointer. 

The VPC process(or) executes a 
portable instruction set tailored to the C 
programming language. System calls and 
interrupt handling are built into the 
instruction set and architecture of the 
VPC process(or). The system calls allow 
programs to access the local and remote 
FIFOs and the Virtual File System (VFS). 
Timing facilities are also built into the 
processor so that simple real-time appli- 
cations can be implemented. 

The VPC process(or) can be com- 
pletely controlled via the 5-bit remote 
control channel. The host can start and 
stop the VPC process(or) and can read 
and write memory. In a typical situation 
the host downloads a small bootstrap pro- 
gram into the VPC process(or) memory 
space. The VPC process(or) is then told 
to execute this bootstrap program, which 
reads a larger bootstrap from the 16-bit 
data channel. The host sends the program 
over the 16-bit data channel. When the 
program has been sent to the VPC pro- 
cess(or), the host requests execution 
using the 5-bit remote control channel. 

The host can also load a small pro- 
gram into the VPC that causes a file from 
the VFS to be loaded into the RAM and 
executed. This avoids the problem of 
lengthy download times from the host. 

The 5-bit remote control channel 
can be used by the host to control the 
VPC process(or). In some respects the 
5-bit control channel can be viewed as a 
remote front panel for the VPC process- 
(or). The 5-bit values (sometimes called 
quibbles for 5-bit nibbles) are divided 
into control codes and data codes. 

If the upper bit of the 5-bit value is a 
one, then the low four bits contain data. 
An internal 16-bit register (called the 
Temporary or T register) is loaded with 
the 4-bit values when they appear on the 
channel. The low four bits of a 16-bit 
word are sent first, followed by the next 
four, and so on. If more than four data 
values (16 bits) are sent, the extra data 
are dropped. This allows for upward com- 
patibility with the 32-bit version of the 
VPC. 

If the upper bit of the quibble is a 
zero, then the low four bits contain a 
control code. The control codes can be 
used to start and stop the VPC pro- 
cess(or), read and write the 64K of mem- 
ory, and read and write the VPC pro- 
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cess(or) registers. The 16 control codes 
are shown in Table I (page 37). 

Two internal registers are used in 
conjunction with the remote control 
channel. The T register is a holding regis- 
ter for quibbles sent from the host; its 
Operation was described above. The P 
(or Pointer) register is used as an auto- 
incrementing pointer to read and write 
memory. The T and P registers are not 
accessible by an application program run- 
ning on the VPC process(or). 

The typical sequence used to load 
data into memory or a register is to send 
the four quibbles of data followed by the 
opcode. The T register is zeroed after an 
opcode is executed, and any quibbles that 
follow are loaded starting in the low-order 
bits as previously described. To get every- 
thing in synch, one usually starts by 
sending a Write P Register opcode first. 
This gets the T register ready to accept 
quibbles. The data is then sent, followed 
by another Write P Register opcode, 
which loads the data just sent into the P 
register. 

At this point the T register is again 
reset to zero, and data can be loaded 
using quibble codes. A Write Memory op- 
code is then sent, causing the contents of 
the T register to be written into the mem- 
ory location(s) pointed to by the P regis- 
ter. The P register is auto-incremented by 
the number of bytes in the word of the 
VPC (currently two for 16-bit VPC). The 
contents of the T register are written into 
memory starting with the least significant 
byte. 

When an opcode is sent that requests 
a read operation, the reverse action occurs. 
The contents of the desired source are 
sent, four bits at a time, followed by the 
opcode that was used to request the read. 
In other words, if a Read Program Counter 
opcode is sent, the contents of the program 
counter will be sent to the host followed 
by a Read Program Counter opcode. 

When a Halt or Run opcode is re- 
ceived by the VPC process(or), the 
proper action is taken and the respective 
opcode is returned to the host as an 
acknowledgment of the request. 


The VPC registers and memory can 
be read (and written) while the VPC is 
executing programs. The returned values 
represent a snapshot taken at the time the 
request reaches the VPC. If the registers 
or memory is changed while the VPC is 
running, unpredictable results can occur. 
The operations are well behaved, but no 
synchronization with the currently run- 
ning program is guaranteed. 

Programs that run in the VPC proc- 
ess(or) have complete control over the 
machine. Data can be exchanged with the 
host or peripherals without host interven- 
tion. Sophisticated, user friendly, front 
end processors can be developed, freeing 
the host from such time-consuming tasks. 
Because the VPC process(or) is totally 


dedicated to this single task, no delays are 
experienced by the user. The user has a 
dedicated personal computer connected 
to the host in an integrated manner. The 
host can utilize as much or as little of the 
power of the VPC process(or) as it desires. 


The User Layer 


The user layer is used to interface the 
VPC process(or) to the peripherals that 
are available to the user. A variety of 
peripheral combinations can be developed 
for various applications. The common 
peripherals are a video display, akeyboard, 
an audio device, a graphics display, and a 
serial printer. All of the peripherals can 
be controlled by the VPC process(or) 
through the local FIFO. 

The local FIFO is similar to the re- 
mote FIFO. The VPC process(or) can 
read and write to the local FIFO at any 
time. Data written into the local FIFO is 
stored and eventually processed by the 
Peripheral Interface Unit (PIU). The PIU 
decodes the upper eight bits of the 16-bit 
word written into the local FIFO as a 
channel number. The lower eight bits are 
sent to the device (or device driver soft- 
ware) connected to the specified channel. 
By convention the lower bit of the upper 
eight bits is used to indicate control or 
data. Each device can be controlled inde- 
pendently of the data flowing between 
the device and the VPC process(or). When 
the bit is a zero a data path is indicated, 
and when the bit is a one a control bit is 
indicated. 

This arrangement allows up to 128 
devices (or drivers) to be connected to 
the PIU. Each device has a control and a 
data path. The control and data paths are 
both bidirectional. Communication be- 
tween the peripherals and the PIU is com- 
pletely asynchronous. No master-slave 
relationships exist except by local conven- 
tions established for specific applications. 

The information exchanged is main- 
tained in a FIFO queue. The queue can 
hold 256 16-bit words for each direction. 
Flow control is the responsibility of the 
VPC process(or) and the peripherals (or 
drivers). Peripherals should not allow the 
FIFO to fill as a means of indicating a 
“not ready’’ condition; the control chan- 
nel should be used for this purpose. This 
prevents the system from completely 
locking up or blocking because a peri- 
pheral is not ready. 

Three virtual peripherals or device 
drivers have been proposed initially for 
the VPC. The Virtual KeYboard (VKY) 
device is used for all key entry and sup- 
ports a typical ASCII type of keyboard 
with function keys and special editing 
keys. The Virtual DiSplay (VDS) device 
is an 80 by 24 monochrome device with a 
simple window-oriented protocol. The 
Virtual AuDio (VAD) device is an 8-bit 
sound generator used to create audible 
tones and simple music. 


The peripherals are connected to the 
PIU using channels 0 (VKY), 1 (VDS), 
and 2 (VAD). Note that the channel num- 
ber is encoded in the upper seven bits of 
the local FIFO word. The low bit selects 
control or data as noted earlier. Therefore, 
the VKY device actually uses binary 
channel O (data) and 1 (control). The 
VDS uses 2 and 3, and VAD uses 4 and 5. 

In the future more peripherals will be 
specified. Channel 3 has been reserved for 
the Virtual PRinter (VRP) driver, and 
channel 4 has been reserved for the Virtu- 
al GRaphics (VGR) driver. The VGR driver 
supports a subset of NAPLPS. 

Even though any 8-bit character- 
oriented device can be connected to the 
local FIFO, a small number of compati- 
ble devices will be specified for anyone 
interested in working on a standard con- 
figuration. The following sections pro- 
vide information on the three primary 
devices: VDS, VKY, and VAD. 


Halt the VPC Process (or) 

Run Starting at Location in PC 
Read Memory *P++ 

Write Memory (*P++=T) 
Read P Register 

Write P Register (i.e., P=T) 
Read Program Counter 


Write Program Counter 
Read Stack Pointer 
Write Stack Pointer 
Read Frame Pointer 
Write Frame Pointer 
Read Argument Pointer 
Write Argument Pointer 
Read Literal Pointer 
Write Literal Pointer 


Table | 
Remote-Control Control Codes 













OO000xxxx Control codes 
0001xxxx Window graphics 
Oxxxxxxx ASCII characters 


1xxxxxxx Set buffer address 


Table Il 
VDS Code Groups 
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VDS: The Virtual Display Device 


The VDS device supports a simple 
window-oriented display compatible with 
80 by 24 terminals. Partial screen scrolling 
is supported as well as business graphics 
for drawing simple forms. 

The VDS protocol consists of 8-bit 
values sent to the VDS device in a stream 
format. The 8-bit bytes can be divided 
into the four groups shown in Table II 
(page 37). The VDS protocol can be 
implemented on most popular terminals 
and personal computers. Figure 3 (be- 
low) illustrates the control codes, window 
graphics, and ASCII characters supported 
by the VDS device. 


VDS Control Codes 


The 16 VDS control codes are listed 
in Table III (right). Most of the con- 
trol codes are self explanatory. One unique 
feature is the concept of marks. A win- 
dow is defined by two marks that deter- 
mine a unique rectangular area on the 
screen. The marks are set by positioning 
the screen address to a specific place and 
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000 
001 
002 
003 
004 
005 
006 
007 
010 
011 
012 
013 
014 
015 
016 
017 


CLW 
CEL 
SM1 
SM2 
SWU 
SWD 
SWL 
SWR 
CON 
COF 
HON 
HOF 
ILI 
DLI 
ICH 
DCH 





CLear Window 

Clear to End of Line 
Set Mark 1 

Set Mark 2 

Scroll Window Up 
Scroll Window Down 
Scroll Window Left 
Scroll Window Right 
Cursor ON 

Cursor OF f 
Highlight ON 
Highlight OF f 

Insert LIne 

Delete LIne 

Insert CHaracter 
Delete CHaracter 


Table Ill 


VDS Control Codes 





Figure 3. 
VDS Codes 


Centered dot 

Up arrow 

Right arrow 
Lower left corner 
Down arrow 
Vertical edge 
Upper left corner 
Left edge right tee 
Left arrow 

Lower right corner 
Horizontal edge 
Bottom tee 

Upper right corner 
Right edge left tee 
Top tee 

Crossing lines 


Table IV 
VDS Window Graphics Codes 
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issuing a Set Mark 1 or Set Mark 2 code. 
Once the marks are set, the various 
window operations apply to the area 
bounded by the rectangle determined by 
the marks. In other words, to clear a por- 
tion of the screen, one sets up an area and 
issues a Clear Window code. 


VDS Window Graphics 


Window graphics are used to create 
forms, tables, windows, and so on. The 16 
window graphics codes have the follow- 
ing basic format: 


0001 xxxx 


The four low bits are used to indepen- 
dently set one of four segments. 

Five of the window codes are not gen- 
erally useful. The code 0000 would pro- 
duce a blank character, which would be re- 
dundant with the ASCII space character 
(octal 040). The window graphics code 
0000 should be displayed as a centered 
dot. This character can be used to indicate 
an unused space in word processing 
applications. 

The codes 0001, 0010, 0100, and 
1000 have only one segment lit and are 
not generally used in window and form 
drawing. These codes are displayed as ar- 
rows oriented so that the tip of the arrow 
exits the side of the cell that would nor- 
mally have a lit segment. The code 0001 
is displayed as an Up arrow. 

The complete set of business graphics 
codes is listed in Table IV (page 38). 


VDS Set Buffer Address 


The buffer address (i.e., cursor posi- 
tion) is set using codes from 128 to 255. 
Direct and relative positioning is provided. 
Direct positioning is performed in rela- 
tion to the physical display screen. Rela- 
tive positioning is performed relative to 
the active window. 


The codes 128-151 are used to set 
the relative address to the beginning of 
any of the 24 rows of the active window. 
Row 0 (i.e., code 128) is the first row 
of the window but not necessarily the 
physical screen. If a row is specified that 
is outside the active window, then a wrap- 
around effect occurs. The column will be 
set to the left-most edge of the active 
window. 

The codes 152-175 are used to set 
the buffer row address (0-23) indepen- 
dently of the current column and current 
window. The codes 176-255 are used to 
set the buffer column address (0-79) 
independently of the current row and 
current window. 


VKY: The Virtual Keyboard Device 


The virtual keyboard driver is an 8-bit 
device that produces 128 codes corre- 
sponding to the keys most commonly 
used in personal computer applications. 
As with other device drivers, the VK Y has 
been designed to support very primitive 
keyboards by mapping common control 
keys to the VKY keys, yet it can support 
the exotic keyboards found on today’s 
personal computers with a direct mapping 
of keys. A balance has been struck be- 
tween the new and the old. 

Figure 4 (below) illustrates the 
VKY (although this keyboard does not 
exist physically). Users should become 
familiar with the mapping of their physi- 
cal keyboards to this functional set. A 
typical dumb terminal used with the Unix 
operating system usually maps the PAUSE 
to CTL-S, ENTER to CTL-D, and EXIT 
to CTL-C or DEL. 

The VKY device has been designed 
to avoid having too many keys available 
for applications. Originally the intent was 
to develop a 256-key generic keyboard 


that would support everything but the 
kitchen sink. Several common keyboards 
were considered (i.e., IBM-PC, DEC-VT 
100, DEC-PC, EPSON QX-10, etc.) from 
which a rather impressive set of keys can 
be assembled. But even though there are 
a considerable number of common keys 
(like A-Z), the lack of consistency was 
discouraging. 

Several problems occur when the 
256-key approach is used. The most 
serious problem is that the average user 
cannot remember 256 functional keys, 
much less the contortions that are involved 
to activate the keys. Another problem is 
that when 256 codes or functions are 
available, the application program must 
be more agile than when only 128 codes 
are used. Lastly, when 256 functional 
key-codes are specified, the mapping of 
those codes to the popular keyboards be- 
comes a rather arbitrary and frustrating 
task. With such a large number of key- 
codes available, all judgment calls end up 
by supporting both keys even though 
they may be very close in function. For 
example, the keys PAGE UP (IBM-PC) 
and PREVious PAGE (DEC-PC) are obvi- 
ously meant for the same purpose. When 
256 codes are available, it is tempting to 
support both in case another computer 
arrives on the scene with both keys. 


The alternate approach chosen for 
the VKY device was to limit the keyboard 
to 128 codes (seven bits). The problem 
with taking this approach is that standard 
ASCII codes fill the entire key table: the 
95 visible character codes plus the 32 
control codes plus DEL make up the 128 
character set. It is obvious that the 95 
visible characters should not be touched. 
The remaining 33 codes are more than 
adequate for function keys and editing 
keys, but the common ASCII control 


alae] [om] eo poepapoeee 
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000 - 003 
004 - 007 
010 - 017 
020 - 037 


040 - 176 
177 


000 
001 
002 
003 
004 
005 
006 
007 
010 
011 
012 
013 
014 
015 
016 
017 
020 
021 
022 
023 
024 
025 
026 
027 
030 
031 
032 
033 
034 
035 
036 
037 


i ec ge ee 
40 


Directional keys (arrows) 


Page keys 


Editing and control keys 
Function/Menu keys 
({1] to [16] ) 


ASCII printable codes 


Exit 


Table V 
VKY Code Groups 


Up 
Down 
Left 
Right 
Begin 
End 
Previous 
Next 
Backspace 
Tab 
New line 
Back tab 
Pause 
Enter 
Delete 
Insert 
[1] 

[2] 

[3] 

[4] 

[5] 

[6] 

[7] 

[8] 

[9] 

[10] 
[11] 
[12] 
[13] 
[14] 
[15] 
[16] 





040 
041 
042 
043 
044 
045 
046 
047 
050 
051 
052 
053 
054 
055 
056 
057 
060 
061 
062 
063 
064 
065 
066 
067 
070 
071 
072 
073 
074 
075 
076 
077 


OMAN OOAAWNH | O™: | 


A =e oe 


AZT 


Table VII 


Backspace (Destructive) 


Tab 


New line 
Back tab 


Pause 
Enter 
Delete 


Insert 


100 
101 
102 
103 
104 
105 
106 
107 
110 
111 
112 
113 
114 
115 
116 
117 
120 
121 
122 
123 
124 
125 
126 
127 
130 
131 
132 
133 
134 
135 
136 
137 


VKY Key-codes 


(Next field) 
(RETURN) 


(Previous field ) 
(Not automatic) 


(Done, EOF, etc.) 
(Character, Page, 


Window, etc.) 
(see Delete) 


Table VI 
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140 
141 
142 
143 
144 
145 
146 
147 
150 
151 
152 
153 
154 
155 
156 
157 
160 
161 
162 
163 
164 
165 
166 
167 
170 
171 
172 
173 
174 
175 
176 
177 


VKY Editing and Control Keys 
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codes have to be eliminated. This is not a 
major penalty because many users are 
confused when confronted with cryptic 
CTL-xx input techniques. 

In fact, it turns out that many of the 
existing ASCII control codes can be pre- 
served because of their widespread support 
on keyboards. New codes can be dropped 
in among the preserved codes, resulting in 
a very terse set of usable keys that almost 
any major personal computer can support 
in a manner that is obvious to a novice 
user. A side benefit of this approach is 
that those systems that have a primitive 
keyboard can use the CTL-xx combina- 
tions to generate the VKY codes because 
CTL-xx codes are not normally supported. 

Another benefit of 7-bit (128) cod- 
ing is that the high bit is now free for use 
as a KEY-SPEED bit. The VKY device 
sets the high order bit to zero when keys 
are struck in a normal manner. The high 
bit should be set to a one when a key is 
generated less than one tenth of a second 
after the previous key. The value in the 
16-bit VTM timer is saved each time a 
key is generated. If another key is gener- 
ated and the value in the VIM timer has 
not changed, the high bit of the new key 
is set to one. 

The KEY-SPEED bit is normally set 
when a user is striking a single key at a 
rapid rate or when a special device (like a 
joystick) is being used to generate key 
strokes. Application programs can always 
ignore the high bit, the only possible pen- 
alty being read-time response. The pre- 
sence of the high bit, however, can be used 
by the application program to indicate 
that it would be wise to raise the priority 
of keyboard processing since keys are 
being pressed at an unusually rapid rate. 
The functionality of each key should not 
be changed by the presence of the KEY- 
SPEED bit. 

Keyboards and terminals with auto- 
repeat functions generate multiple keys 
when keys are continuously held. Keys 
are usually repeated 15 to 30 times per 
second. The high-order bit periodically 
will be set to one when auto-repeating 
keyboards are used. This is normal, and 
the application program can use this 
information to the best of its ability. 


If special devices (like joysticks or 
touch pads) are used to generate multiple 
keys, then the KEY-SPEED bit should be 
set to indicate that a high-speed key 
input device is being used. Again, the 
KEY-SPEED bit should be used to indi- 
cate not a change in functionality but 
rather a change in key generation speed. 


Various studies and large amounts of 
head holding have resulted in the follow- 
ing specification for the VKY device 
driver. One must keep in mind that the 
spirit of this effort is to identify function- 
ality and not key-top identification. The 
VKY device keys can be grouped into the 
six groups shown in Table V (above). 
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For just $295 MAGIC/L™ is yours. And suddenly 
you find you’ve bought more than a language. 
MAGIC/L is an entire interactive environment; 
an assembler, a compiler, an editor, an 1/O pack- 
age, and a system call facility are all wrapped up 
and delivered. And now MAGIC/L is available 
for CP/M-based computers. 

MAGIC/L is easy to learn. It has syntax similar 
to C and Pascal, and because it’s extensible as well 
as interactive, it dramatically increases productivity. 

Program development features include a built-in 
text editor, command line recall, CCP, STAT, and 
PIP command emulation, and the ability to store 
keyboard dialog on disks. 

Key language features include: CHAR, INTEGER, 
LONG, REAL, and String data types; record struc- 
tures similar to the STRUCT facility in C; anda 
complete I/O package that can provide random 
access, variable length I/O to any CP/M file. 


TO WRITE 


Bet you can't stop 





ROGRAM 
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with one. 


And MAGIC/L offers great portability. Source 
code which runs on CP/M can be compiled 
unmodified and run on any other processor. 

Typical applications include hardware interfac- 
ing, process control, games creation, interactive 
graphics and image processing. MAGIC/L has 
made programming easier for DEC, 68000, and 
Data General users. Now it’s working for CP/M 
users too. 

MAGIC/L provides everything you need to 
write a complete program. But the only way to be 
convinced is to try it yourself. Send us your $295 
check or money order—we also accept Master- 
Card and VISA— we'll send MAGIC/L for CP/M to 
you at once. A full money back guarantee is part 
of the package. Once you’ve sampled that first 
program, you'll have to try another. . . and 
another. . . and another. MAGIC/L . . . it’s more 
than a language. 


MAGIC/L.. . It’s more than a language 
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VKY Directional Keys 


The directional keys are the first four 
key-codes. The four directions (up, down, 
left, and right) are provided. Arrow keys 
are usually used to generate these codes. 
When diagonal movements are desired, a 
two-code sequence should be used with 
the KEY-SPEED bit set in the second key 
to indicate the composite action: if the 
application program makes use of the 
KEY-SPEED bit, it can interpret the two 
moves as a single move. 

Users with only four arrow keys can 
achieve the same result by pushing two of 
the direction keys in rapid succession. 
Sophisticated keyboard detection schemes 
can also be used to allow a user to push 
two arrow keys at the same time. The 
resulting codes sent to the application 
program are the same. 

If joysticks, mice, or touch discs are 
used, an appropriate stream of direction 
keys should be generated. 


VKY Editing and Control Keys 

This group of eight keys is probably 
the most controversial. This group has 
been formed as a result of careful selec- 
tion with an eye toward the past, present, 
and future. The functionality of the keys 
may not be as controversial as the recom- 
mended physical keyboard equivalents. 
The functional codes are shown in 
Table VI (page 40). 


VKY Function Keys ([1] to [16] ) 


The codes 020-037 are very straight- 
forward. They are used to encode special 


function keys that are used by an applica- 
tion in a specific manner. It is expected 
that these codes should be generated by 
physical keys that can be relabeled for 
the application. In units that have only 10 
function keys (like the IBM-PC), it is an- 
ticipated that some CTL or ALT arrange- 
ment will be used to generate all 16 keys. 
When terminals like the VT-100 are used, 
the typical approach is to convert the 
numeric keypad into a function key clus- 
ter. When this approach is used, a two-key 
sequence can be used for each function 
key. The function keys [1] to [9] are 
actually generated by the sequences 
[O][1] to [0][9]; the function keys 
[10] to [16] can be generated by two-key 
sequences [1][0] to [1][6]. When the 
[0] key is pressed, the device waits for 
another key to make a final determination. 

Another approach that can be used 
with a numeric keypad is to map the keys 
[1] to [9] to the function keys [1] to 
[9], with the [0] key treated as function 
[10]. The keys [11] to [16] are gener- 
ated by the two-key sequences [1][1] to 
[1] [6]. This approach requires that 
timing detect the difference between [1] 
and [1][X] combinations. This can be 


‘accomplished by starting a timer whenever 


the [1] key is pressed. If another key 
does not follow in a short period of time 
(maybe one second), the [1] function 
key is generated. 

The latter approach to using the nu- 
meric keypad is usually more popular 
because the majority of the function keys 
can be generated by a single key-stroke. 


00 01 10 11 
0000 A 55.00 C# 138.59 F 349.23 A 880.00 
0001 A# 58.27 D 146.83 F# 369.99 A# 932.32 
0010 B 61.73 D# 155.56 G 392.00 B 987.76 
0011 C 65.41 E 164.81 G# 415.00 C 1046.52 
0100 C# 69.29 F 174.61 A 440.00 C# 1108.72 
0101 D 73.42 F# 184.99 A# 466.16 D 1174.64 
0110 D# 77.78 G 196.00 B 493.88 D# 1244.52 
0111 E 82.41 G# 207.50 C 523.25 E 1318.52 
1000 F 87.31 A 220.00 C# 554.36 F 1396.92 
1001 F# 92.50 A# 233.08 D . -387.33 F# 1479.96 
1010 G 97.99 B 246.94 D# 622.26 G 1568.00 
1011 G# 103.75 C 261.63 E 659.26 G# 1660.00 
1100 A 110.00 C# 277.18 F 698.46 & 1760.00 
1101 A# 116.54 D. 293.66 F# 739.98 A# 1864.64 
1110 B 123.47 D# 311.13 G 784.00 B 1975.52 
1111 C 130.81 E 329.63 G# 830.00 C 2093.04 
Table VIII 


VAD Note Codes 


Other methods can be devised; it does not 
matter how the function keys are gener- 
ated as long as the proper key-codes are 
generated for the application program. 


VKY ASCII Key-codes 


The codes 040-176 are equally 
straightforward. They are generated by 
the common ASCII punctuation and 
alphanumeric keys. The physical Shift 
key is typically used to access the upper- 
case and lower-case characters. 

It should be noted that keys like 
Shift, Shift Lock, and Numeric Lock are 
all considered to be private to the key- 
board and/or VKY device driver. The 
application program does not need to 
know precisely how the key was gener- 
ated: it is concerned only with the inten 
of the user. : 


VKY Exit Key 


The last bit of functionality needed 
in most applications is the Interrupt or 
Attention capability. The key-code 0177 
is used to encode this function. The key 
has been named Exit to balance out the 
Enter key and some of the terminology 
from the system. 

The physical DEL (Delete) key can 
be used for the Exit function although 
the ESC (Escape) key can be equally use- 
ful. Note that the normal ASCII ESC 
code 033 is used by the F12 special func- 
tion key, which means the physical ESC 
key is now available. The CTL-C combi- 
nation is another popular key used to 
generate the Exit key-code. 


If the distinction between functional 
(logical) and physical keys is still confus- 
ing, the following example may help. If 
the ESC key is chosen for the Exit func- 
tion, then each time the ESC key is pressed 
the VKY device should send the VPC 
processor an 0177 code indicating an Exit. 
The application program running in the 
VPC should always interpret the 0177 
kKey-code as an Exit request whether or 
not it knows that the ESC key was used 
to generate the code. Alternate physical 
keys that can be used for Exit are the 
BREAK key or the DEL key. The DEL 
key should be used as a last resort because 
it is more commonly used to generate the 
Delete key-code (octal 016). 


Each of the keys shown in Figure 4 
generates a key-code. Table VII (p. 40). 
illustrates all of the key-codes supported 
by the VKY device. The key-codes should 
be handled by an application program as 
functional codes rather than as physical 
codes. The physical keys that are pressed 
do not have to be precisely labeled with 
the key-codes in the table. The user 
Should be concerned with the desired 
function rather than the physical keys, 
This emphasis on functional keys allows 
application programs to be portable 


across a variety of machines. 
42 | | 
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VAD: The Virtual Audio Device 


The Virtual Audio Device is an 8 -bit 
device that allows a VPC program to 
generate simple sounds and music. Each 
8-bit value written to the VAD device is 
used to immediately start a note of a 
particular frequency. The low six bits of 
the 8-bit byte are used to specify one of 
64 notes. The upper two bits indicate the 
duration of the note. 

The 64 notes correspond to the most 
common notes found in music. The notes 
range from A (note 0) two octaves below 
middle C to C (note 63) three octaves 
above middle C. Only the legal piano notes 
are supported. This arrangement allows 
six bits to represent tones from 55.0 Hz 
to 2953.0 Hz. The 64 notes are shown in 
Table VIII 9 (page 42) along with the 
frequency in Hz (cycles per second). The 
labels on the top of each row represent 
the high two bits of the note code. 

The upper two bits of the 8-bit VAD 
code are used to control the duration of 
the tone. Table IX (at right) illustrates 
the four possible duration settings. The 
timing of the VAD tones is synchronized 
to the VTM timer. The VTM timer is a 
free-running 16-bit timer that is used by 
the VPC process(or) to schedule events 
and for other timing applications. The 












and tedious. 


C Programmers: 
Program three times faster 
with Instant-C” 


Instant-C™ makes programming three or more times 
faster by eliminating the time wasted by traditional 
compilers. Many repetitive programming tasks are 
automated to make programming less frustrating 


e Twoseconds elapsed time from completion of 


VTM timer ticks (i.e., increments) every 
one tenth of a second. 

When an 8-bit byte is written to the 
VAD sound generator, the sound is in- 
stantly started. The note is played until 
one, two, three, or four ticks of the VIM 
timer occur. If a previous sound is still 
being played when a new value is loaded, 
the old sound stops and the new sound 
begins. 

Note that if a sound is started very 
close to the next tick of the VTM timer 
and only one tick is requested then a 
short note may be heard. Normally, the 
VAD device is loaded as part of the VIM 
interrupt handler, which is executed at 
the beginning of a VIM time interval. 
This more or less guarantees that a full 
tenth of a second note will be generated. 
When two, three, or four ticks are re- 
quested, the notes will play for approxi- 
mately two, three, or four tenths of a 
second, respectively. 


The automatic turn-off feature of 
the VAD sound generator is extremely 
useful when a host computer wishes to 
send an isolated note to a terminal to 
alert the user. The host program can ad- 
dress the code to the VAD data channel, 
and the sound will be loaded, played, and 
ended without further codes being sent 


Turn off on next tick 

Turn off on tick after next 
Turn off on third tick 
Turn off on fourth tick 


Table IX 
VAD Duration Codes 





from the host. 

The VAD device can be used to gener- 
ate the common ASCII BEL code for 
backward compatibility with existing 
applications. The code for middle C 
(00011011) is normally used. 

On systems without a general pur- 
pose sound generator, middle C is usually 
detected and converted to the BEL char- 
acter on the terminal being used. When 
music is sent to a VPC, the occasional oc- 
currence of middle C in a song will ring 
the BEL. The user may not be able to 
enjoy the song, but at least something is 
heard to indicate music is being played. 
The user is usually given the option to 
turn this feature off in the Set-up capa- 
bility local to a VPC. 


WOW! 


P-R-O-P-O-R-T-|I-O-N-A-L 
Spacing on WordStar 


You are reading text printed by WordStar in 
proportional spacing, providing a profes- 


sional, easy to read, typeset appearance. 


between words, are 


Complete details 
for printing in 
proportional spa- 
eing directly from 


















editing to execution. 


e Full-screen editor integrated with compiler; 
compile errors set cursor to trouble spot. 


e Editor available any time during session. 
Symbolic debugging; single step by statement. 


Automatic recompilation when needed. Never a 
mismatch between source and object code. 


Directly generates .COM, .EXE, or .CMD files. 
Follows K & R—works with existing source. 
Single, integrated package. 

e Works under PC-DOS*, MS-DOS*, CP/M-86*. 


More productivity, less frustration, better programs. 
Instant-C™ is $500. Call or write for more information. 


. 617) 653-6194 
Rational PO. Box 506 
Systems, Inc. 


provided. The tech- 
niques will work on 
all versions of 
WordStar, and will 
drive Diablo, 
Xerox, Qume, NEC, 
on a page, and and other daisy- 
underlining spaces wheel printers. 


Above text printed on a daisywheel printer direct from WordStar. 
Now you can have the professional appearance of typeset 
text. Using PS is as easy as turning on bold or underline and is 
done right in your document, then printed by WordStar 


automatically! 
PS ON WordStar-S20 postpaid 
Copies. Enclosed is my check (or Visa/MC # and 
, made out to: 
WRITING CONSULTANTS 
Suite 165 / 11 Creek Bend Drive 
Fairport, New York 14450 
Orders Only, Call Toll Free 1 -800-227 -3800 Ext. 7018 
Dealer inquires invited. 


WordStar, setting 
two or more fully 
justified columns 


Please send me 
exp. date) for $. 


Natick, Mass. 01760 


*(Trademarks: PC-DOS (IBM), MS-DOS (Microsoft), CP/M-86 (Digital Research, Inc.) 
Instant-C (Rational/Systems, Inc.)] 





Circle no. 87 on reader service card. 


Circle no. 64 on reader service card. 
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The Levels of VPC 


At the present time three basic VPC 
configurations are defined. For a lack of 
better names, they have been designated 
level 0, level 1, and level 2. 

The level 0 VPC is a terminal-only 
implementation. The local and remote 
FIFOs are patched together so that the 
host can communicate with all of the 
serial device drivers. The 5-bit control 
channel is not connected to anything and 
will not respond. No downloading of soft- 
ware can be performed. No files can be 
transferred. 

The level 0 VPC can be used in appli- 
cations that require a simple audio, video, 
and keyboard combination. Up to 128 
serial devices can be handled using the 
standard FIFO driver interface techniques. 
Each key that is generated by the VKY is 
sent to the host. Likewise, all VDS screen 
control must come from the host. 

A level 0 implementation of VPC has 
been developed by Unir Corporation for 
members of The Unir Project. It is availa- 
ble to members for $50.00 and includes a 
complete C language source code listing. 
Even though the package has been writ- 
ten for the industry standard VT-100 
terminal, it can be easily adapted to other 
terminals. 

Figure 5 (below) shows the mod- 
ules included with the level 0 VPC pack- 
age. The listings included with this article 
comprise the two rightmost elements 
(C78 and C87) and the two parts of the 
level O VPC (MUXPIU and PIUMUX),. 
The relatively lengthy code for the VDS 
and VKY is not included. /Jf readers 
show sufficient interest, we will run the 
code for those modules in a future issue. 
— Ed.] 

The level 1 VPC is a diskless version 
with all of the level 0 features plus the 
64K RAM and VPC processor. Down- 
loading can be done from the host using 
the 5-bit control channel in conjunction 
with the remote FIFO. 

The level 1 VPC boots in the level 0 








VT100 






TERMINAL 


terminal mode. The local and remote 
FIFOs are patched together, and the VPC 
processor begins looping and checking the 
two FIFOs. Data that appear on one 
FIFO are transferred into the other. 

The level 2 VPC is equipped with a 
file system (VFS) for local file storage. 
Using the VPC processor, files can be 
stored and retrieved. A standard Unix- 
like hierarchical file system is assumed by 
the system calls. 

The level 2 VPC boots from a file 
designated during the local setup phase 
of VPC. This file is loaded into the RAM 
(using the exec system call) at location 0 
and given control. The standard default 
boot file brings the VPC up running the 
same program as level O and level 1. 

The VPC level can be detected ina 
variety of manners. The first step is to 
attempt to read the program counter 
using the 5-bit control channel. If no re- 
sponse occurs, a level 0 VPC is being 
used. If a response comes back, a level 1 
level 2 VPC is in use. 

Further memory interrogation can be 
done to determine if a level 2 VPC is be- 
ing used. As a convention, the level 2 
VPC will have arge and argv set during the 
file loading process. The name of the file 
can be determined by interrogating the 
argument stack. In contrast, the level 1 
VPC will not have the file name on the 
Stack. 


Testing Your VPC 


Unir Corporation is providing a free 
data line for people interested in testing 
their VPC implementations. The data line 
features a member directory, a bulletin 
board service, a news service, and several 
VPC exercise programs. 

A level 0 VPC is needed to access the 
system. A 7-bit asynchronous, even pari- 
ty data link is used to simplify the access. 
The system can be reached 24 hours a 
day by dialing (317) 842-7014. 

More information on VPC, the VPC 


(MUXPIU) 


Level 


(Pi{UMUX} 


Figure 5. 
Level 0 VPC 





data line, and The Unir Project can be 
obtained from Unir Corporation, 5987 
E. 71st Street, Suite 106, Indianapolis, 
Indiana 46220. 


Conclusion 

The virtual personal computer is a 
general system for integrating timesharing 
and personal computer systems. The VPC 


replaces the common CRT and keyboard 


with a complete programmable worksta- 
tion. The primary source of programming 
for the VPC comes from a host system 
and not the user. 

The VPC can be used as a simple 
terminal or as a powerful component in 
a distributed processing system. Programs 
can be downloaded from a host into the 
VPC memory and can be executed as 
high-speed, real-time tasks. Files can be 
transferred between the VPC and the host 
without extra hardware or software. A 
wide variety of peripherals can be con- 
trolled by the VPC using a general pur- 
pose I/O capability. The user interfaces 
to the VPC and ultimately to the host, 
through these peripherals. 

Unlike many software systems, a 
VPC makes no prior assumption about 
how these various capabilities are going to 
interact. Because of this, a VPC can be 
configured as a multi-screen terminal 
emulator, as a real-time front-end proces- 
sor, or a simple personal computer. Con- 
cepts like windows and concurrent, multi- 
plexed I/O are easily integrated into a 
system using a VPC. As the system 
evolves, the VPC can be reconfigured to 
meet the demands of new applications. 

The VPC is extremely useful in 
bridging the gap between personal com- 
puters and large, time-shared systems. 
This gap represents one of the next major 
frontiers in the computer industry. BBJ 


(Listing begins on page 46) 
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SWIG" 


SOFTWARE WRITERS INTERNATIONAL GUILD 


SCHEDULED 
SWIG ACTIVITIES & 
MEMBERSHIP BENEFITS 


(1) $10,000 PROGRAMMING 
CONTEST (Members only) 


(2) NATIONAL COMPUTER 
WEEK (May 11-May 20, 
1984) 


(3) ANNUAL CONFERENCE 
AND SOFTWARE AWARDS 
CEREMONY (During 
National Computer Week) 


(4) CONSULTANT REGISTRY 
(With computer store refer- 
ral system for customized 
software) 


(5) JOB PLACEMENT SER- 
VICE (Free to individual 
members, fixed maximum 
fee to companies) 


(6) FREE SEMINARS & 
MEETINGS LOCALLY 


(7) SOFTWARE LIBRARY 
LENDING & EXCHANGE 
SERVICE (Professional 
quality assemblers, 
utilities, games, etc.) 


(8) SOFTWARE LOCATION 
SERVICE (For companies 
& individuals-if it exists, 
SWIG will find it. If not, 
see #9) 


(9) SOFTWARE DEVELOP- 
MENT SERVICE (From 
novice to scientist, SWIG 
members can work on any 
project-from applications 
to games to R&D) 


(10) LEGAL SERVICE 


(11) AGENT (SWIG can 
represent you in sales to 
software publishers) 


(12) 24 HOUR - 7 DAY BULLE- 
TIN BOARD SYSTEM 
(BBS) ACCESSIBLE BY 
COMPUTER FREE 


(13) AND MORE!!!! 


THE LARGEST PAID MEMBERSHIP PROGRAMMERS GUILD - 
OVER 5,000 MEMBERS WORLDWIDE!! 


MEMBERSHIP APPLICATION FOR 
SOFTWARE WRITERS INTERNATIONAL GUILD 


NAME 





ADDRESS 





CITY _ STATE ZiP 








PHONE # ( ) 





® CLASSIFICATION: 
[) NOVICE [] BEGINNER TO ADVANCED 
(J ADVANCED WITH ON THE JOB EXPERIENCE [] RESEARCH/SCIENTIST 


® WHAT EQUIPMENT DO YOU HAVE EXPERIENCE WITH &/OR ACCESS TO &/OR 
PLAN TO BUY? 


CO MAINFRAME (©) MINI © MICRO (© DESIGN/R&D 

BRAND NAME(S): © IBM (© XEROX © APPLE’ OTI 

[) COMMODORE () RADIOSHACK ATARI ~~ OSBORNE 

© TIMEX/SINCLAIR © NORTHSTAR ~~ (© HEWLETT PACKARD 

[1] OTHER ar 9 








© AREAS OF INTEREST: 
(J DATA PROCESSING (J BUSINESS APPLICATIONS [] GRAPHICS 
(] LEGAL [} VOICE (} MEDICAL (] APPLIANCE (HOME) CONTROL 
(J ROBOTICS [] GAMES [] MUSIC 1) R&D 1) OTHER 





@® MEMBERSHIP ACTIVITIES AND SERVICES OF INTEREST: 
READ THE LIST ON THE LEFT AND CIRCLE THE NUMBERS BELOW THAT APPLY. 
1 2 3 3) 6 7 8 9 10 11 12 


1 | HAVE ENCLOSED $20 ANNUAL MEMBERSHIP FEE C1 CK [1 MO 
(MAKE CHECK PAYABLE TO: SWIG) 


RETURN TO: SWIG 
P.O. BOX 87 
STONY POINT, NEW YORK 10980 
(914) 354-5585 


SWIG© SOFTWARE WRITERS INTERNATIONAL GUILD 


Circle no. 76 on reader service card. 
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Virtual Personal Computer text begins on page 32) 
Listing One 


#inelude <stdio.» 


/* 

# 

# convert 8 bit mux format (mux) 

al to 7 bit even parity format (c7e) 
#/ 

/* 

* 

# even parity table 

8 

# / 


char parity[] = { 

0x00 ,0x80 ,0x80 ,0x00 ,0x80 ,0x00 ,0x00 ,0x80, 
0x80 ,0x00 ,0x00 ,0x80 ,0x00 ,0x80 ,0x80 ,0x00, 
0x80 ,0x00 ,0x00 ,0x80 ,0x00 ,0x80 ,0x80 ,0x00, 
0x00 ,0x80 ,0x80 ,0x00 ,0x80 ,0x00 ,0x00 ,0x80, 
0x80 ,0x00 ,0x00 ,0x80 ,0x00 ,0x80 ,0x80 ,0x00, 
0x00 ,0x80 ,0x80 ,0x00 ,0Ox80 ,0x00 ,0x00 ,0x80, 
0x00 ,0x80 ,0x80 ,0x00 ,0x80 ,0x00 .0x00 ,0x80, 
0x80 ,0x00 ,0x00 ,0x80 ,0x00 ,0x80 ,0x80 ,0x00, 
0x80 ,0x00 ,0x00 ,0x80 ,0x00 ,0x80 ,0x80 ,0x00, 
0x00 ,0x80 ,0x80 ,0x00 ,0x80 ,0x00 ,0x00 ,0x80, 
0x00 ,0x80 ,0x80 ,0x00 ,0x80 ,0x00 ,0x00 ,0x80, 
0x80 ,0x00 ,0x00 ,0x80 ,0x00 ,0x80 ,0x80 ,0x00, 
0x00 ,0x80 ,0x80 ,0x00 ,0x80 ,0x00 ,0x00 ,0x80, 
0x80 ,0x00 ,0x00 ,0x80 ,0x00 ,0x80 ,0x80 ,0x00, 
0x80 ,0x00 ,0x00 ,0x80 ,0x00 ,0x80 ,0x80 ,0x00, 
0x00 ,0x80 ,0x80 ,0x00 ,0x80 ,0x00 ,0x00 ,0x80 


}5 

int lbase = 0; /* last base #/ 
/* 

% 

# 8 bit characters are read that contain 

# 8 bits of data 

% they are converted to 7 bit format and 

z even parity is set in the upper bit 

#/ 


main(arge ,argv,envp) 
int arge; 

char *argv[ 
char *envp[ 


LJ bd 
‘ee we 


setbuf (stdin ,NULL); 


setbuf (stdout ,NULL) ; 
new win(0); 
while((c=getchar()) != EOF){ 


Fe a OE OS UNCER TAGE gE OD ee 
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ge SN EN RR EE REET A PE BESET PASTAS LI cE SLD SRE ERS ER SSE SESE AR EEA SS AES OR RSIS SERRE ch RR SEE A A ESS 


put c7e(c); 
} 
/* 
# 
# set up new window 
8 
% the offset of 8 is not encoded . 
# but is set for later use eet! Gt een eens = es ee 
% 
% / PE eis eree nce reremamnnta teen a naane cre tere sion inane neregnce ET EO TNO shen ath essa asin nada barra psinsc ona eso srarion 


new win(byte) 
ces byte; CA ea ee caret a tine panc pa tae toate ae te eR ti nC Oem EEN AN NCEA Rae ioe “a 

itaae — ((oyte-B) 2 Oxo. «°Bs DE eine mane hatuind Ataris sxe thet Sire cede OMS Ten bea ere nas. pte ee icles Ceae 
put par( (lbas®>5) + 32); —-—-—-— ar — ae a 


a) 


ME 


convert 8 bit bytes ne 
i O - b 7 t : ae orma t Seer Da sheer A Sa eS n SR SNH eae EB SS lL INTRO OTS RE PRIA A LHD ae SPE eA IS IE GEM RGSS Eas Pp plete 


7 bit format 


3 bit base + 8 XXX01000 
6.45 bit offset + OxXXXXXX 


8 bit result XXXXXXXX 


Lhe 3 bit base is enedded: °°: ain rs tS SISTERS COREA See ORE SR TS do een ae ete ee ee RS a 
as numbers in the range = ———_—___— Re arte etter ee 


32 to 390 ——i—i‘é*C Re ie 


the extra offset of 8 is added i Qayyeeemeremme 6060606060600 eel itttttemtimne ee 


to provide more efficiency = | j= ————MAtdtc=Rial  ---=«<ss_ tte 
when handling ASCII files (iC) weruy j.é JD 


the extra offset of 8 is now et nith 90/Zenitt ae -AUUS ZAM LUZ : 
encoded but is assumed as 
shown above 


the 6.45 bit offset is encoded as 
n umb S i Ss in t he i an g e uu 0 to 1 2 T ssssassssisaahiiaai sess aea toa a ica aaa 


the 3 bit base is only changed 
when necessary 


if consecutive 8 bit numbers 6 Ws omb\y Cossiame a (o,41 0) (cums Dy-tec mm Qreyententveat(erlaleyers 


fall in the same range then the 
* hit Rese ia ‘shared’ and Software You Can Buy. 


each 8 bit byte will only require MITE is now available for 
1 byte containing a 6.45 bit offset al AV AA VI DO XS 


as well as CP/M-S80. 
the codes 0 to 31 are never 
enountered | DYo-l (a ame-tale Mott jaulobiceyamlecelbiielocmuya (ee)seten 
so that control codes can be used 


for flow control and other purposes MYCROFT 
LofsSinc 


P.O. Box 6045, Tallahassee, FL 32314 (904) 385-1141 


Circle no. 47 on reader service card. AT 


xxeencneununnKeKeKNR KKK KEK KKK KKK KKK KKK KKK KKK KN 


“x Ke x 


(Continued on next page) 
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edward k. ream 





FULL SCREEN EDITOR 
with 
FULL SOURCE CODE in C 


for 


CP/M 68K or CP/M 80 


e RED is a powerful yet simple text editor for 
both programmers and writers. 


e RED features 17 commands including block 
move, block copy, search and substitute. 


e RED is the only text editor supplied with full 
source code for the BDS C, Aztec CII and 
Digital Research C compilers. 


e RED is the only text editor that you can 
change to suit your needs and tastes. 


e¢ RED is the only text editor that will not 
become obsolete when you change systems. 


¢ RED supports all features of your terminal. 
You tailor RED to your terminal with an 
easy-to-use configuration program. 


e RED handles files as large as your disk. 


e RED is guaranteed. If for any reason you are 
not satisfied with RED, your money will be 
refunded promptly. 


Price: $50. 


For more valuable information, call (608) 231-2952 


To order, send $50 to: 
Edward K. Ream 
1850 Summit Avenue 
Madison, Wisconsin 53705 


Your order will be mailed to you within one week. Sorry, I can 
not handle credit cards. Please do not send purchase orders unless 
a check is included. 


Dealer inquiries invited. 





Virtual Personal Computer 
Listing One 


(Listing continued, text begins on page 32) 


# the codes 128 to 255 are not used 

% the high order bit is available for 
# a parity bit if needed 

# 

#/ 


put e7e(byte) 
int byte; 
{ 
if (( (byte-lbase )&0xff) > 87) { 
new win (byte); 


} 
put off (byte-lbase) ; 


} 

/* 

% 

# output 6.45 bit offset 

¥ 

* the offset should be in the range 
% 0 to 87 

¥ 

#/ 


put of f(offset) 
int offset; 


{ 
} 
j* 
* 


# output 7 bits with even parity 
® 


*/ 


put par(offset + 40); 


put par(c) 
ime Os 
{ 
O82 Oxits 
putchar(e | parity[e]); 


End Listing One 
(Listing Two begins on page 50) 
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SOFTWARE DESCRIPTIONS 


TPM (TPM 1) - $80 A Z80 only operating system which is 
capable of running CP/M programs. Includes many features not 
found in CP/M such as independent disk directory partitioning for 
up to 255 user partitions, space, time and version commands, date 
and time, create FCB, chain program, direct disk 1/0, abbreviated 
commands and more! Available for North Star (either single or 
repeat oar: TRS—80 Model | (offset 4200H) or II, Versafloppy 
_ or Tarbell I. 


TPM-II -$125 An expanded version of TPM which is fully CP/M 
2.2 compatible but still retains the extra features our customers 
have come to depend on. This version is super FAST. Extended 
density capability allows over 600K per side on an 8" disk. Availa- 
ble preconfigured for Versafloppy II (8" or 5”), Epson QX-10, 
Osborne |i or TRS-80 Model II. 


CONFIGURATOR | 
This package provides all the necessary programs for 
Customizing TPM for a floppy controller which we do 
not support. We suggest ordering this on single den- 
sity (8SD). 

Includes: TPM-Il ($125), Sample PIOS (BIOS) SOURCE 
(SFREE). MACRO II ($100), LINKER ($80), DEBUG | ($80). 
QED ($150). ZEDIT ($50), TOP | ($80). BASIC | ($50) and 


BASIC II ($100) NOW $250 


$815 Value 


CONFIGURATOR II 
Includes: TPM-I! ($125). Sample PIOS (BIOS) SOURCE 
(SFREE). MACRO |! ($100). MACRO Ill ($150), LINKER 
($80). DEBUG | ($80), DEBUG I! ($100). QSAL ($200). QED 
($150), ZTEL ($80). TOP II ($100), BUSINESS BASIC 
($200) and MODEM SOURCE ($40) and DISASSEMBLER 
($80) 
$1485 Value NOW $400 
MODEL | PROGRAMMER 
This package is only for the TRS-80 Model |. Note: 
These are the ONLY CDL programs available for the 
Model |. It includes: TPM | ($80). BUSINESS BASIC 
($200), MACRO! ($80), DEBUG | ($80), ZDDT ($40). ZTEL 
($80), TOP | ($80) and MODEM (S46) 

$680 Value NOW $175 


MODEL Il PROGRAMMER 
This package is only for the TRS-80 Model I 
It includes: TPM-Il ($125), BUSINESS BASIC ($200). 
MACRO |i ($100), MACRO III ($150). LINKER ($80). 
DEBUG | ($80), DEBUG I! ($100), QED ($150). ZTEL ($80). 
TOP Il ($100). ZDDT ($40), ZAPPLE SOURCE ($80). 
















































QSAL 


Software 





DEVELOPER | 
Includes: MACRO | ($80). DEBUG | ($80). ZEDIT ($50). 
TOP | ($80). BASIC | ($50) and BASIC II NOW 

$440 Value NOW $1 50 














DEVELOPER II 
Includes: MACRO 1! ($100), MACRO Ii! ($150), LINKER 
($80), DEBUG | ($80), DEBUG || ($100), BUSINESS BASIC 
($200), QED ($150), TOP II ($100), ZDDT ($40), ZAPPLE 
SOURCE ($80), MODEM SOURCE ($40), ZTEL ($80), and 








DISASSEMBLER ($80). 
$1280 Value 


DEVELOPER Ill 
Includes: QSAL ($200), QED ($150), BUSINESS BASIC 
($200). ZTEL ($80) and TOP II ($100) 

$730 Value NOW $300 


COMBO 
includes: DEVELOPER 1! ($1280). ACCOUNTING PACK- 
AGE ($300), QSAL ($200) and 6502X NO 


NOW $350 





















$1930 Value W $500 


LINKER - $80. A linking loader for handling the linkable 
modules created by the above assemblers 


DEBUG I - $80. A tool for debugging Z80 or 8080 code. 
Disassembles to CDL/TDL mnemonics compatible with above 
assemblers. Traces code even through ROM. Commands include 
Calculate. Display. Examine. Fill. Goto. List. Mode. Open File. Put. 
Set Wait. Trace. and Search. 


DEBUG II - $100. A superset of Debug |. Adds Instruction 
Interpreter. Radix change. Set Trap/Conditiona! display. Trace 
options. and Zap FCB 


6502X - $150. A 6502 cross assembler. Runs on the Z80 but 
assembles 6502 instructions into 6502 object code! Similar features 
as our Macro assemblers 


QSAL - $200. A SUPER FAST 280 assembler. Up to 10 times 
faster than conventional assemblers. Directly generates code into 
memory in one pass but also to offset for execution in its own 
memory space. Pascal like structures: repeat...until. if...then...else. 
while...do. begin...end. case...of. Multiple statements per line. 
special register handling expressions. long symbol names, auto 
and modular assembly. and more! This one uses ZILOG Mnemonics 


QED - $150. A screen editor which is both FAST and easy to 
learn. Commands include block delete, copy. and move to a 
named file or within text, repeat previous command. change. 
locate. find at start of line. and numerous cursor and window 
movement functions. Works with any CRT having clear screen, 
addressable cursor, clear to end of line, clear to end of screen, and 
80X24. 


DISK FORMATS 





ZTEL - $80. An extensive text editing language and editor 
modelled after DEC’s TECO. 


ZEDIT - $50. A mini text editor. Character/line oriented. Works 
well with hardcopy terminals and is easy to use. Includes macro 
command capability 


TOP I - $80. A Text Output Processor for formatting manuals. 
documents. etc. Interprets commands which are entered into the 
text by an editor. Commands include justify. page number, head- 
ing. subheading. centering, and more 


TOP II - S100. A superset of TOP |. Adds: embedded control 
characters in the file. page at a time printing. selected portion 
printing. include/merge files. form feed/CRLF option for paging. 
instant start up. and final page ejection. 


ZDDT - $40. This is the disk version of our famous Zapple 
monitor. It will also load hex and relocatable files. 


ZAPPLE SOURCE - $80. This is the source to the SMB 
ROM version of our famous Zapple monitor. It can be used to 
create your own custom version or as an example of the features 
of our assemblers. Must be assembled using one of our assemblers. 


MODEM - Acommunication program for file transfer between 
systems or using a system as a terminal. Based on the user group 
version but modified to work with our SMB board or TRS-80 
Models | or Il. You must specify which version you want. 


MODEM SOURCE - $40. For making your own custom 


version. Requires one of our Macro Assemblers. 


DISASSEMBLER - $80. Does bulk disassembly of object 
files creating source files which can be assembled by one of our 


assemblers. 
HARDWARE 


S-100 — SMB Ii Bare Board $50. “System Monitor Board” for 
S-100 systems. 2 serial ports, 2 parallel ports, cassette inter- 
face, 4K memory (ROM, 2708 EPROM. 2114 RAM), and power 
on jump. When used with Zapple ROM below, it makes putting 
a S-100 system together a snap. 

Zapple ROM $35, Properly initializes SMB 1/Il hardware. pro- 
vides a powerful debug monitor. 

IBM PC — Big Blue 280 board $595. Add 280 capability to your 
IBM Personal Computer. Runs CP/M programs but does not 
require CP/M or TPM. Complete with Z80 CPU, 64K add on 
memory. serial port. parallel port, time and date clock with 
battery backup. hard disk interface, and software to attach to 
PC DOS and transfer programs. Mfr'd by QCS. 
50°% Discount on all CDL software ordered at the same time as 
a Big Blue (and for the Big Blue). 

APPLE II — Chairman 280 $345, Add 280 capability to your 
Apple il/ll Plus computer. Runs CP/M programs with our 
more powerful TPM. Includes 64K memory add on (unlike the 
competition this is also useable by the 6502/D0S as well as 
the 280), TPM, QSAL assembler. QED Screen Editor, and Busi- 
ness Basic. Mfr'd by AMT Research. 

Apple Special $175, Buy the Apple Z80 Developer at the same 
time as the “Chairman” and pay only $175 instead of $325. 


APPLE Z80 DEVELOPER 
Includes: 6502X ($150), MACRO |! ($100), MACRO Il 


($150), QSAL ($200), QED ($150), LINKER ($80), DEBUG | 
($80), DEBUG II ($100), ZDDT ($40) and BUSINESS 


BASIC ($200) NOW $325 


VALUE: $1250 
$175 when purchased with AMT “Chairman” Board 


ORDERING INFORMATION: 













When ordering software specify which disk format you would like. 


VISA/MasterCard/C.0.D. ears 
Call or Write With Ordering ee, 


Information... 


OEMS: 


Many CDL products are available for 







MODEM ($40), MODEM SOURCE ($40) and DISAS- 
CODE DESCRIPTION 


SEMBLER ($80) 
$1445 Vaiue NOW $375 

Ee oH 8SD 8” IBM 3740 Single Density (128 bytes/26 sectors/77 tracks) 

BASIC I - $50, a 12K: basic interpreter with 7 digit precision. 80D 8” Double Density (256 bytes/26 sectors/77 tracks) 


BASIC II - $100. A 12 digit precision version of Basic |. 8XD 8” CDL Extended Density (1024 bytes/8 sectur/77 traceks 616K) 
BUSINESS BASIC - $200. A full disk extended basic with 


random or sequential disk file handling and 12 digit precision 





5SD 5.25" Single Density (TRS80 Model |, Versafloppy |. Tarbell |) 


(even for TRIG functions). Also includes PRIVACY command to SEP 5.25” Epson Double Density ; 

protect source code, fixed and variable record lengths. simultane- 5PC 5.25" IBM PC Double Density licensing to OEN’s. Write to Carl 
ous access to multiple disk files, global editing. and more! 5XE 5.25" Xerox 820 Single Density Galletti with your requirements. 
ACCOUNTING PACKAGE - $300. Written in Business 50S 5.25” Osborne Single Density ies nvited 

Basic. Includes General Ledger. Accounts Receivable/Payable. 5ZA 5.25" 280 Apple (Softcard compatible) Dealer Inquiries Invited. 


and Payroll. Set up for Hazeltine 1500 terminal. Minor modifica- 


tions needed for other terminals. Provided in unprotected source TPM INFO When ordering TPM | or Il. in addition to Disk Format. please specify one of the following codes: 


{opm CODE DESCRIPTION 

MACRO | - $80. A Z80/8080 assembler which uses CDL/TDL TPM!: | NSSD/H = North Star Single Density for Horizon !/0 

mnemonics. Handles MACROs and generates relocateable code NSSD/Z North Star Singte Density for Zapple 1/0 

includes 14 conditionals, 16 listing controls. 54 pseudo-ops, 11 NSDD/H North Star Double Density for Horizon 1/0 For Phone Orders ONLY Call Toll Free... 


(Except Pa.) 


arithmetic/logical ops. local and global symbols. linkable module 
generation, and more! 


MACRO II - $100. An improved version of Macro | with 
expanded linking capabilities and more listing options. Also inter- 


NSDD/Z North Star Double Density for Zapple 1/0 


TRS80-1 © TRS-80 Model | (4200H Offset) 
TRS80Il_ TRS-80 Model | 


1-(800) 458-3491 


Ask For Extension #15 


nal code has been greatly improved for faster more reliable vis Versafloppy | 8" ; 

aperation Vis Versafloppy | 5.25 For information and Tech Queries call 
MACRO II1-$150. Anenchanced version of Macro lll. Internal = TPM-Il: VIB Versafloppy II 8 (XD) (609) 509-2146 

buffers have been increased to achieve a significant improvement ViI5 Versafloppy 11 5.25 

in speed of assembly. Additional features include line numbers TRS8OIl_ TRS-80 Model II (XD) 






cross reference. compressed PRN files. form feeds. page parity 
additional pseudo-ops. internal setting of time and date. and 
expanded assembly-time data entry. 


Prices and Specifications subject to change without notice. 
TPM. Z80. CP/M. TRS80 are trademarks of CDL. Zilog. DRI and Tandy respectively. 


Computer Design Labs ")" 


34? Columbus Avenue/Trenton, NJ 08629 === 
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Public Domain 


(and user supported) 


Software 

for the IBM PC 

Word Processing, communications, data 
base, BASIC utilities, games using color 
graphics, Pascal and assembly language 
programs, FORTH language, graphics 
drawing utilities, spreadsheet templates, 
RAM disks, spoolers, and more... 
Directory $2.95 + $1 postage 
Set of 10 most popular disks $59 


File system, modem communications, spooler, RAM 
disk, BASIC utilities, FORTH language, games 


Complete set of 75 disks $439 
DOS 1.1/2.0 compatible format 
(CA residents add 6.5% sales tax) 














PC Software Interest Group 
1556 Halford Ave. Suite #130W 
Santa Clara, CA 95051 
(408) 247-6303 
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cefi22 INTRCEPT  cdos 


9, Cee as Ney 
NEW version for 1984! 


eEnables programs written for Digital Research 
CP/M 2.2 to run under Cromemco CDOS and 
vice versa. INTRCEPT release 3 automatically 
recognizes the host system, and emulates 
CP/M 2.2 if the host is CDOS, or emulates 
CDOS if the host is CP/M 2.2. 
¢No programming, delivered ready-to-run. 
¢ Customizable...comes with CDOS emulator 
source, CP/M 2.2 emulator source optional. 
¢Z80 assembly language, no program or 
operating system modifications. 
$150 w/CDOS emulator source 
$250 w/CDOS & CP/M emulator source 


8” SSSD, inquire about 5%” 
add $3 shipping, add 6% tax in CA 
VISA, MC,check 

































microSystems 
16609 Sagewood Lane 
Poway, California 92064 
(619) 693-1022 






Circle no. 59 on reader service card. 


1-1 (-lero)aalaallallerzidlelal-T¢ 





Tr) O] gee) "0 


SOFTCOM is a smart terminal and file 

transfer utility all in one easy to use 

package. SOFTCOM can: 

¢ make your system a terminal to a 
HOST time sharing system. 

* capture data onto your disk from a 
HOST time sharing system. 

¢ send text and program files from your 
disk to almost any type of computer. 

® exchange any type of file with another 
SOFTCOM system with error detec- 
tion and automatic retry. 

SOFTCOM runs on all CP/M based 

computers. Three license options are 

available: single CPU ($150), dual CPU 

($250) and multi CPU ($450). Call our 

software HOT LINE 906/228-7622. 
The Software Store 

706 Chippewa Square * Marquette MI 49855 




















Circle no. 73 on reader service card. 


50 






Virtual Personal Computer 
Listing Two 
(Listing continued, text begins on page 32) 


#inelude < stdio. 
# include <sgtty. 
# include < signal. 


/* 
# 

# convert 7 bit even parity format (c7e) 
al to 8 bit mux format 

% 


*/ 
Let 7 ye bee Ge 


struct sgttyb savtty; 
struct sgttyb newtty; 


/* 
# even parity table 
*/ 
char parity[] = { 

0x00 ,0x80 ,0x80 ,0x00 ,0x80 ,0x00 ,0x00 ,0x80, 


0x80 ,0x00 ,0x00 ,0x80 ,0x00 ,0x80, 0x80 »Ox00, 
0x80, 0x00 0x00, 0x80 0x00, 0x80, 0x80 "0x00, 


0x00 ,0x80 ,0x80 ,0x00 ,0x80 ,0x00 ,0x00 ,0x80, 


0x80 ,0x00 ,0x00 ,0x80 ,0x00 ,0x80 ,0x80,0x00, 
0x00 ,0x80 ,0x80 ,0x00 ,0x80 ,0x00 ,0x00 ,0x80, 


0x00 ,0x80 ,0x80 ,0x00 ,0x80 ,0x00 ,0x00 ,0x80, 
0x80 ,0x00 "0x00, "0x80 "0x00, "0x80, 0x80 "0x00, 
0x80 ,0x00 "0x00, 0x80 "0x00, "0x80, 0x80 "0x00, 
0x00 ,0x80 ,0x80 ,0x00 ,0x80 ,0x00 ,0x00 0x80, 
0x00, "0x80 "0x80, "0x00 "0x80, "0x00, "0x00 "0x80, 
0x80 ,0x00 0x00, "0x80 "0x00, 0x80, "0x80 "0x00, 
0x00 ,0x80 ,0x80 ,0x00 ,0x80 ,0x00 ,0x00 ,0x80, 
0x80, 0x00 0x00, 0x80 "0x00, "0x80, "0x80 "0x00, 
0x80 ,0x00 "0x00, "0x80 "0x00, 0x80, "0x80 "0x00, 


0x00 ,0x80 ,0x80 ,0x00 ,0x80 ,0x00 ,0x00 ,0x80 


5 

/* 

% 

# 8 bit characters are read 

# the lower 7 bits contain data and the upper 
* bit has even parity set (hopefully) 

# 

# parity is tested and if an error occurs 
# the character is dropped 

% 

#/ 


main(arge ,argv, senvp ) 
int arge; 

char *argv[]; 

char *envp[]; 
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tac Cs 
int data; 
int resexit(); 


init(); 

signal (SIGINT ,&éresexit); 

signal (SIGHUP ,&resexit) ; 

signal (SIGPIPE ,&éresexit); 

while((c=getchar()) != EOF) { 
data = c & Ox7f; 


if(parity[data] == ((char) (c&0x80))) { 


put mux(data); 


else { 


fprintf(stderr ,"%s: parity error %o\n",argv[0],c); 


} 


restore(); 


# init the tty if needed 


(Continued on next page) 
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Available now. 


The Best of Both Worlds 


High-performance 
CompuPro Hardware 


with high-performance 


Cromemco Software. 
3 Cromemco’s MC68000-Z80 CROMIX multi-tasking 
operating system with drivers to support CompuPro hardware. 
(requires Cromemco DPU) 
Minimum configuration: 


DPU - SystemSupport! - Disk] - Interfacer3 or 4 - 192K RAM 


CROMIX with drivers to support minimum configuration $890. 
Special drivers only $295. 


FETETTTT TE FEE ET EEE E ETT PEE TET TE 
The following products can be added to any 8 or 8-16 bit CROMLX system: 


SCSI hard disk drivers $195. 


15Mb formatted hard disk subsystem $2095. 
30Mb (two drives) $2995. 


4 MDrive-H drivers $195. 
CompuPro 512K MDrive-H hardware $1695. 
Rh eB ee ee ee rr ee a 





Other drivers ii development... custom inquiries welcome. 


Authorized CompuPro Dealer. 


PuterParts’ 
2004 4th Avenue 
P.O. Box 12339 

Seattle, WA 98111-4339 


Telephone (206) 682-2590 


OPEN 
2-6 Tuesday-Saturday 





*PaterParts” is a registered trademark 
of Katharos Companies 
Additional trademarks: Z80, Zilog: MC68000, Motorola: CROMIX, DPU, Cromemco: 
SystemSupporil, Diskl, Interfacer3, -4, MDrive-H, CompuPro. 
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INTELLIBURNER 


EPROM-EEPROM-MICROCOMPUTER PROGRAMMER 


UNIVERSAL PROGRAMMING CAPABILITIES 
AT AN AFFORDABLE PRICE 


e Ultra Fast Programming - 2716’s in 16 Seconds 

e Programs & Verifies 8K thru 256K Single Voltage EPROMs 

e Erases, Programs & Verifies 2815 & 2816 EEPROMs 

e Programs & Verifes 8748 and 8751 Series MICROCOMPUTERS* 

e Programming Characteristics Selected by Convenient 
Personality Jumper Plug (Dip Header) 

e Program, Verify, Status, & Diagnostic Display with Tricolor LED 

e Serial Interface — 3, 4, or 5 wire — 1200 to 19200 Baud 

e Supports XON/XOFF and READY/BUSY Protocols 


NO SPECIAL SOFTWARE REQUIRED. Transfer disk files (Intel Hex Format) to EPROM 
with your system’s line printer or modem software. Transfer EPROM contents to disk file 
in Intel Hex Format with your system’s modem software. Or use the supplied software ** 
to transfer any binary or ASCII file to/from EPROM. 


PROGRAMS : 


2758 2716 27128 27C16 2815 8748* 
2516 2732 27128A 2816 8749* 
2532 2732A 27256 8751* 
2564 2764 68764 8741* 8742* 
*Requires low cost personality adapter avail. 6/84 


SOFTWARE AVAILABLE FOR :** 
CP/M systems on 8” SSSD - many 5% formats 
TRS-80 Model Ill TRSDOS 1.3 
Heath H8/H89 HDOS & CP/M 
ZENITH Z90 & Z100 CP/M 
KAYPRO 


IntelliBurner Programmer with Software $ 269.00 
RS-232 Interconnect Cable 9.00 





Low Cost ‘‘DumBurner’’ serial 
programmers harness the power of your es CS £eee 
personal computer with the supplied 14397 Darlene Way-Sulte A12 


software for full rogrammin 
capabilities : os . Boulder City, Nevada 89005 


DumBurner II Programmer for 28 Pin and PHONE (702) 293-7426 
24 Pin EPROMs and EEPROMs(with Software) $ 189.00 

DumBurner II Bare PC Board, Plans & Software 39.00 

16K/32K DumBurner for 24 Pin EPROMs (with Software) 139.00 

16K/32K DumBurner PC Board, Plans, & Software 25.00 


Add $2.00 Shipping & Handling; C.0.D.s accepted; Foreign Orders add required postage. Specify Environment and Media 
Requirements. H8, H89, Z100 are TM Heath/Zenith; CP/M is TM Digital Research. TRS-80 Model Ili is TM Tandy Corp, 
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MicroMotion 


FORTH 


The Professional Choice. 


52 


Make it yours. 


Everything for the FORTH user 
from start to finish. 










Meets the 1983 International 
standard for portability 


e 200 page tutorial and reference 
manual 


Available for APPLE Il and Z-80 
CP/M (many disc formats) 


e Floating point extension 


e HIRES graphics extension (APPLE Il 
& North Star Advantage only) 


e Screen editor with definable 
controls 













Macro assembler with local labels 
Applications 
MicroMotion FORTH — $90. - $140. 
Publications 
FORTH-83 Intemational Standard 


FORTH-83 compatible source 
listings for 6502, 8080, Z-80 and 
8086 microprocessors 


e FORTH-83 Standard — $15.00 
Source listings — $20.00 












Contact us for our most up-to-date 
product information! 


Circle no. 43 on reader service card. 



















MicroMotion 
12077 Wilshire Bivd., Ste. 506 

Los Angeles, CA 90025 
(213) 821-4340 


Virtual Personal Computer 
Listing Two 
(Listing continued, text begins on page 32) 


init() 
{ 


ew 


eee RKK KKK KR KK KKK KKK KEK KKK KH KK KKK RK Ke Ke eK OK RN 


if (isatty(0) == 1){ 
Ciyl ig = 1s 
gtty(0,&savtty); 
gtty(0,&newtty) ; 
/* echo implicitly off ¥*/ 
newtty.sg flags |= RAW; 
newtty.sg flags &= ~ECHO; 
stty(0,&énewtty); 
setbuf (stdin ,NULL) ; 
setbuf (stdout ,NULL) ; 


send to mux 


convert 7 bit bytes 
to 8 bit format 


7 bit format 


3 bit base + 8 XXX01000 
6.45 bit offset + OxXXXXXX 


8 bit result XXXXXXXX 


the 3 bit base is encoded 
as numbers in the range 
32 to 39 


the extra offset of 8 is not 


encoded but is assumed as 
shown above 


the 6.45 bit offset is encoded as 
numbers in the range 40 to 127 


the 3 bit base is only changed 
when necessary 


if consecutive 8 bit numbers 
fall in the same range then the 
3 bit base is "shared" and 


each 8 bit byte will only require 
1 byte containing a 6.45 bit offset 


the codes 0 to 31 are never enountered 


so that control codes can be used 
for flow control and other purposes 


the codes 128 to 255 are not used 
the high order bit is available for 


(Continued on page 54) 
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Full-screen text editor; designed 
to be used either with -TPL or by 
itself. 

e Full cursor control; 

e Insert mode with word wrap; 
e ‘Paint’ mode; 

e Single-keystroke or dual- 















The Text Processing Language. A 








text-file runoff program con- east” 
2 


sisting of a set of text-processing 
primitive commands from which 
more complex commands 
(macros) can be built (as in Logo). 
Features include: 
¢ Complete customization of 
text processing through 
macro definition and expan- 
sion, looping structures, and 
conditional statements; 
e Adapts to any printer; 
e Pagination; 
e Text justification and center- 


gv8\, wi an 


got 


DBX 


Blocked Keyed Data Access 
Module. Maintains disk files of 
keyed data. Can be used for 
bibliographies, glossaries, multi- 
key data base construction, and 
many other applications. 

e Variable-length keys; 

¢ Variable-length data; 

e¢ Sequential access and rapid 












The Pascal Data Management 
System. A_ user-oriented data 
management system in_ which 
numeric and alphanumeric data 
are stored in tables with named 
columns and numbered rows. 
Currently being used for dozens 
of different kinds of business and 
scientific applications, from in- 
ventory management to laborato- 
ry data analysis. Includes over 20 
Pascal programs; more than 
10,000 lines of code. Main 









keystroke commands; 

¢ Command synonyms; 

¢ Global search and replace; 

¢ Block move, block copy; and 
block delete. 


$50 


SCINTILLA 


A log logit curve fitting program 


a AtcMie oe bey hae. features include: for radio-immunologic data; must 

° Indexing and tables of con- e Single disk access per opera- eo , 

tents; : Han Re find, delete) in ¢ Maximum of 32,767 rows per i si eS Dee sereenten 
A : ; “is above). 

e Superscripts and subscripts; most cases; file; rare 

® Bolding By jbdctinke: e Multiple files; ¢ Maximum of 400 characters SEE UD IE OCeE IBGS 


e Multiple headers and footers; 

e End notes and footnotes; 

e Widow and orphan suppres- 
sion; 

e Floating tables and ‘keeps.’ 


$50 


e Dynamic memory allocation 
for RAM-resident index and 
current “page” of entries; 

¢ Includes demonstration pro- 
gram and testbed program. 


$50 


per row, and 40 columns per 
table; 

Full-screen editing of rows 
and columns, with scrolling, 
windowing, global search/ 
replace, and other editing 
features; 


© Quality control files; 
e Four-parameter non-linear 


curve fit. 
$250 


UCSD formats only. 






Sorting, copying, merging, 
and reducing routines; 
Mailing label program; 
Reporting program generates 
reports with control breaks, 
totals and subtotals, and 
selects rows by field value; 







. 
gi 
Suet VER OE 
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CHROME Sort 


































MINT 
















PLANE ; 
many other reportin : 
Chromatography data analysis aia ih a A terminal emulation program for 
program: Planimetry program: ‘ce oe ae oan communication between com- 
¢ Graphic display of analog e Bit-pad entry of cross sec- “ross-tabulation, correla- Silsees utinirsice, 
data; tions; tions, and multiple regres- 


e User-configurable uploading 


e Panning and zooming; e Real-time turtlegraphics sion; . and Gowiloadind of fies: 
e Automatic peak-finding and display; ¢ Video-display-handling © X-ON/X-OFF and 
baseline calculation; e Calculation of areas; module; 









EOB/ACK protocols; 

e Interrupt-driven serial input 
(for Prometheus Versacard in 
Apple II); 

e Printer-logging. 


$50 


¢ Disk-file-handling module. 
Many other features. UCSD for- 


mats only. 
$250 


e Full interactive peak editing; e Saves calculations to text 
¢ Computation of peak areas; file. 
e Strip charts on C. Itoh and 

EPSON printers. $100 


$100 






For more information, call 919-942-1411. To order, use form below or call our toll-free number: 1-800-XPASCAL 


Check appropriate boxes: 











FORMAT PRODUCT PRICE os 
[} 8” UCSD SSSD _] DBX $ 50 
[) 51%4” Apple Pascal _] PDMS $250 
[) 5%” UCSD IBM PC 320k C) TPL $ 50 Rado 
be nme O A ane >. [_] MasterCard [_] visa L] Check Ek 60.p: 
[1] 544” IBM MS-DOS CL) MINT $ 50 
1) 51%4” CP/M Osborne O SCINTILLA er (Please include card # 
q ane. $100 and expiration date) SUBVER SIV E A division of Pascal & Associates, 





SOFTWARE : oa 
le P l trademarks of the APPLE Computer Corp. IBM and IBM PC are trademarks of International Business 135 East Rosemary St., Chapel Hill, NC 2 

A aceaa esp Prorat is a trademark of the Regents of the University of California. Osborne is a trademark of Osborne Com- 

an "EPSON is a trademark of EPSON America, Inc. C. Itoh is a trademark of C. Itoh Electronics. 
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We make C easy... 
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and work! 





Eco-C compiler... we've got it all. 


Whether you're a seasoned professional or just get- 
ting started in C, the Ecosoft C compiler has every- 
thing you'll ever need. 


COMPLETENESS: 

Our Eco-C compiler is a complete implementation 
of C and supports all operators and data types (includ- 
ing long, float and double). 


EFFICIENCY: 

The compiler generates extremely efficient Z80 
code using Zilog’s mnemonics. On the benchmarks 
tested, typically we finished either first or second 
using substantially less generated code. 


PORTABILITY: 

The ECO-C library contains over 100 functions 
that are UNIX V7 compatible, and includes a complete 
transcendental package. Programs developed with the 
Eco-C compiler can be moved to virtually any system 
with little or no change. 


EASE OF USE: 

The Eco-C compiler includes Microsoft’s MACRO 
80 assembler, linker, library manager and supporting 
documentation. The assembler (M80) generates 
industry-standard REL file output. The linker (L80) is 
fast and uses only the functions you request in the 
program. Program development is a snap. 

The user’s manual is clear, concise and full of useful 
information. For those of you just getting started with 
C, we also include a copy of the C Programming 
Guide (Que). This B. Dalton Best Seller has been 
adopted by a number of leading universities around 
the country and is included with each compiler. The 
book is designed to help you learn C from the ground 
up. We ought to know... we wrote the book. 

We've made the compiler easy to work with for the 
professional and beginner alike. Most error messages, 
for example, tell you in English (not just a number) 
the line number and character position of the error, 
what was expected and a page reference to the Guide 
to consult for help if you need it. 

PRICE: 

We saved the best for last; we've cut the price by 
$100.00. Now you can buy the Eco-C compiler for 
only $250.00 (MACRO 80 and the book alone are 
worth $218.00!). Shop around and we think you agree 
that the Eco-C compiler is the best value available. 

The Eco-C compiler requires a Z80 CPU, CP/M, 
54K of free memory and about 240K of disk space 
(one or two drives). An IBM-PC version will be avail- 
able in the first quarter of 84. To order your Eco-C 
compiler, call or write. 

2 
























































Ecosoft Inc. 


me P.O. Box 68602 
BCOSOFT Inc. 


Indianapolis, IN 46268 Capita 
(317) 255-6476 (ence) 
TRADEMARKS: 


Eco-C (Ecosoft), MACRO 80 (Mic rosoft), CP/M (Digital Research) 
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Virtual Personal Computer 
Listing Two 


(Listing continued, text begins on page 32) 


# a parity bit if needed 


put mux(c) 

int ¢c; 

{ 
static int lbase = 0; 
char byte; 


byte = c & Ox7f; 
if (byte >= 32){ 
if(byte < 40){ 
lbase = ((byte-32) << 5) + 8; 
} 


else{ 


} 


putchar ((byte-40)+lbase) ; 


# restore and exit 


resexit() 


restore(); 
exit(); 


% restore the tty 


restore() 


{ 
if (ttyflg == 1){ 
stty(0,&savtty); 
} 


End Listing Two 
(Listing Three begins on page 56) 


a i a 
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eNEW 


pRODUCTS® 


Before Johann Sebastian Bach developed 
a new method of tuning, you had to 
change instruments practically every time 
you wanted to change keys. Very difficult. 


Before Avocet introduced its family of 
cross-assemblers, developing micro-pro- 
cessor software was much the same. You 
needed a separate development system 
for practically every type of processor. 
Very difficult and very expensive. 


But with Avocet’s cross-assemblers, a 
single computer can develop software for 
virtually any microprocessor! Does that 
put us in a league with Bach? You decide. 


The Well-Tempered Cross-Assembler 


Development Tools That Work 


Avocet cross-assemblers are fast, reliable 
and user-proven in over 3 years of actual 
use. Ask NASA, IBM, XEROX or the hun- 
dreds of other organizations that use them. 
Every time you see a new microprocessor- 
based product, there’s a good chance it 
was developed with Avocet cross- 
assemblers. 


Avocet cross-assemblers are easy to use. 
They run on any computer with CP/M” 
and process assembly language for the 
most popular microprocessor families. 


51/4” disk formats available at no extra 
cost include Osborne, Xerox, H-P, IBM 
PC, Kaypro, North Star, Zenith, 
Televideo, Otrona, DEC. 


Turn Your Computer Into A 
Complete Development System 


Of course, there’s more. Avocet has the 
tools you need from start to finish to enter, 
assemble and test your software and finally 
cast it in EPROM: 


Text Editor VEDIT -- full-screen text edi- 
tor by CompuView. Makes source code 
entry a snap. Full-screen text editing, plus 
TECO-like macro facility for repetitive 
tasks. Pre-configured for over 40 terminals 
and personal computers as well as in user- 
configurable form. 


CP/M-80 version 
CP /M-86 or MDOS version 
(when ordered with any Avocet product) 


EPROM Programmer -- Mode! 7128 
EPROM Programmer by GTek programs 
most EPROMS without the need for per- 
sonality modules. Self-contained power 
supply ... accepts ASCII commands and 
data from any computer through RS 232 
serial interface. Cross-assembler hex ob- 
ject files can be down-loaded directly. 
Commands include verify and read, as 
well as partial programming. 


PROM types supported: 2508, 2758, 
Ooie 2 ilo... 2ooe, eloe, Talaee, 
27C32, MCM8766, 2564, 2764, 27C64, 
27128, 8748, 8741, 8749, 8742, 8751, 
8755, plus Seeq and Xicor EEPROMS. 


eevee eeeeeseeeeeeeesee 






Avocet 
Cross-assembler 


¢ XASMZ80 

e XASM85 
XASMO5 
XASMO9 
XASM18 
XASM48 
XASM51 
XASM65 
XASM68 
XASMZ8 
XASMF8 
XASM400 
XASM75 


NEC 7500 





(Upgrade kits will be available for new 
PROM types as they are introduced.) 


Programmer 
Options include: 

e Software Driver Package -- 

e enhanced features, no installation 
e required. 


a Mgt) wi ds cay hie 4k he OMS oe eS a OL ce.” 


* CP/M:-80 Version: 5 ax seeks a ay Ase 
BAIR URE Version tai os aes $ 95 
BS Ao ase tite ee $ 30 


8748 family socket adaptor... $ 98 
8751 family socket adaptor ... $174 
e 8755 family socket adaptor .. . $135 


Target CP/M-80 ne 
Versions e 


$300.00 
COP400 each 


















¢ CP/M-86 








$250.00 


each 





$200.00 
each 










e $500.00 


Call Us 


If you're thinking about development sys- 
tems, call us for some straight talk. If we 
don’t have what you need, we’ll help you 
find out who does. If you like, we'll even 
talk about Bach. 


CALL TOLL FREE 1-800-448-8500 
(In the U.S. except Alaska and Hawaii) 


VISA ‘and Mastercard accepted. All popular disc formats now 
available -- please specify. Prices do not include shipping and 
handling -- call for exact quotes. OEM INQUIRIES INVITED. 


* Trademark of Digital Research ** Trademark of Microsoft 


e G7228 Programmer by GTek -- baud 
e to 2400 ... superfast, adaptive program- 
e ming algorithms ... programs 2764 in one 
e minute. 


wt Ser nD ay et. Fee Pol hb) 6 seme 6) BO ge! ee 


* Programmer 
e Ask us about Gangand PAL programmers. 


e HEXTRAN Universal HEX File Con- 
e verter -- Converts to and from Intel, 
e Motorola, MOS Technology, Mostek, 
e RCA, Fairchild, Tektronix, Texas 


e Instruments and Binary formats. 


@ Converter, each version 


Circle no. 4 on reader service card. 


AVOCET 
SYSTEMS INC: 


DEPT. 

804 SOUTH STATE STREET 
DOVER, DELAWARE 19901 
302-734-0151 TELEX 467210 





Virtual Personal Computer (Listing continued, text begins on page 32) 
Listing Three 


# include <stdio.p 


/* 

* 

# multiplexor to piu conversion 

% level 0 

% 

#% an 8 bit stream is read from the standard input 

% and a 16 bit stream is written on the standard output 

# 

# the 8 bit stream usually comes from the ¢c78 converter or 
# other link level processors 

% 

# the 16 bit stream that is written on the standard output 
*% is created by writing 2 bytes 

* the low byte is written first followed by the high byte 
% the 16 bit channel is usually sent to a PIU or YDS module 
# 

#/ 


unsigned base = 03 


/* 
# 
# mux input 
# 
% break down as follows: 
# 
# OXXXXXXX - add base to XXXXXXX yielding 16 bit data 
# 1OXXXXXX - set middle 6 bits of base 
* 110XXXXX - set upper 5 bits of base 
% 111XXXXX - 5 bit remote control channel value 
% 
% the 5 bit remote control channel is dumped because this 
# is a level 0 VPC utility 
8 
*/ 
main() 
ins. -e; 
int data; 


setbuf (stdin ,NULL ) ; 
setbuf (stdout ,NULL3 ; 
while((c=getchar()) != EOF) { 
Lite <<. tees 
data = base + (c&0x7f); 
put piu(data); 


else{ 
if(e< 192){ 
base &= Oxf81f; 
base |= (c&0x3f) << 53 


} 
else { 
if(e <]22t){ 
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base &= Ox07ff; 


base 


else { 
/* 


} 


/* 
% 
# output to piu 
B 
#/ 


put piu(data) 
int data; 


putchar(data & Oxff); 
putchar( (data@> 8)&0xff ); 


“.. by far the best debugging tool 


available for the IBM-PC today.” 
S. Lerner, Multi Systems Group 


Ko CodeSmith=-86 
OS 


B fabcode exe CodeSmith-86 


2001 0002 
2001 0003 
Pali 

2004 06 
§BEC 


FRHIBP). BX 


AS5EF6 ( 
2001 OO0E 8956F4 > FAH BP}, DX >SET A BREAKPOINT 


2001 0011 80761E 

2001 0014 F3A4 REPNZ — MOVS 
2001 0016 2410 NO 
2001 0018 


JUUTTIUU HANDLE JIK 
45 DB 69 FORCE COD 
MEMORY DUMP 
at Abso Address Q3C9¢ Segment Offs 9056 


304 00 


ENTER DUMP ADDRESS 
0304 0050 4 j 43 
03C4 0060 
03C4 0070 ah fr | Be 2-55 47 47 49° 4 MA} 
0364 0080 20 41. 20.42 4C 41 43 54-21 20 20 20 20 20 21 A BLAS] 

- Simple/single keystroke commands 


¢ Scroll up/down thru full-screen disassemblies | 
*SCREENSAVE Mode 
Saves and restores user’s graphic display when 
breakpoint hit 
- Continuous monitoring of selected memory 
¢- Hundreds of tagged breakpoints supported 
¢ Disassemble selected ranges of memory code 
to disk—compatible w/IBM Assembler 
¢ Many other inspired features 
VISUAL AGE Requires MS-DOS 
MasterCard * VISA * COD Orders & 160K RAM (min.) 


642 N. Larchmont Blvd., Los Angeles, CA 90004 
(213) 439-2414 CodeSmith, TM International Arrangements, Inc. 


MS, TM Microsoft Corp. IBM, TM International Business Machines Corp. 





Circle no. 83 on reader service card. 





(c&O0x1f) << 11; 


eat the control channel */ 


End Listing Three 
(Listing Four begins on page 58) 


DISK DRIVES 


NEW — Full O.E.M. Warranties too! 
TANDON 


Model Number 
TM-100-1 
TM-100-2 
TM-101-4 
TM-50-1 
TM-50-2 
T4-55-4 

All Manuals 
TM-848E-2 half 
TM-502 12.8mb Winchester 
TM-503 19.8mb Winchester 1100 
TM-703 30.1mb Winchester 1425 


300-1200 Baud RS-232MODEM 250 
Direct connect std. Auto Ans/Originate. 
~Optional Autodial/Smart Pkg. 50 


ADLER COMPUTER SYSTEMS COMPANY, 
125 Chandler st., Buffalo,N.Y. 14207 


Phone (716] 876-1600 | NYS Residents 


US$ 

Type tpi Height Price 
SSDD 48 full 177 
DSDD 48 full 220 
DSDD 96 full 270 
SSDD 48 half 160 
DSDD 48 half 200 
DSDD 96 half 250 
10 
380 
1000 


8”DSDD 48 


Circle no. 1 on reader service card. 
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Virtual Personal Computer (Listing continued, text begins on page 32) 
Listing Four 


# include < stdio.» 


/* 

# 

# piu to multiplexor converter 

# level 0 

# 

* this program reads the standard input and converts a 16 bit 
# stream to multiplexor format 

* the standard input contains 16 bit values encoded as 2 
sl bytes, low byte followed by high byte 

S 4 

# the standard output is used and contains data in 8 bit 
# multiplexor format 

% the output is usually directed to a link level process 
ie 

# / 


unsigned base = 0; 


main() 

int low; 

int high; 

setbuf (stdin ,NULL) ; 

setbuf (stdout ,NULL) ; 

while((low=getchar()) != EOF) { 

high = getchar(); 
put mux(((high & Oxff) << 8) + (low & Oxff)); 

ale 
} 
/* 
z 
a send 16 bit data value through mux 
* there are other clever ways of setting the base values 
* to yield better link performance 
* this method is easy to program and describe 
2 
# if the value to be sent can be reached using the current 
% base then only a 7 bit offset is sent 
* if the value can not be reached, a new base is 
# determined by the upper 11 bits of the current value 
* the 5 and 6 bit sub-base registers are compared with the 
% current base register and one or both are changed as needed 
the value is then sent using this new base 
*/ 


put mux(value) 
unsigned value; 


{ 
unsigned diff; 
unsigned new bas; 


if((diff = (value - base)) < 128){ 
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putchar (diff ); 


if({new bas & Oxf800) != (base & Oxf800)){ 
putchar(((new bas & Oxf800) >> 11) | OxcO); 


} 
if((mew bas & 0x07e0) != (base & 0x07e0)){ 
putchar(((new_bas & 0x07e0) >> 5) | 0x80); 


} 
else { 
new bas = value & Oxffe0; 
putchar(value & Ox1f); 
base = new bas; 


End Listing Four 








= “We bought and evaluated over $1500.00 
z=: ‘C’ compilers...C/80 is the one we use.” 
a Dr. Bruce E. Wampler, Aspen Software 


author of ‘“Grammatike Ee 


aed ™ 

2 EZ Full featured C Compiler for CP/M® with 
== |/0 redirection, command expansion, 
=: execution trace and profile, initializers, 
sz: Macro-80 compatibility, ROMable code. 
= OPE SR NER Betis Adds 32 bit data 
=== types to C/80 3.0 compiler. Includes 
=== |/0 and transcendental function library. 







TTT all or write for 16 page booklet 
==: detailing our programming languages LISP/80, 
z=. RATFOR, Assemblers, and 25 other CP/M products. 





Circle no. 74 on reader service card. 





ANSWER: 


A little gumbo, 
a lot of jazz, and 


Dr. Dobb's Journal 


QUESTION: 


What will I find 
at SOFTCON? 


Feb. 21-23 


See us in booth #2045 under 
the Superdome in New Orleans. 


PO. Box E, Menlo Park, CA 94026 


Re ee 
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PABX and the Personal 


Computer 





ou are probably wondering why a 
Y journal like Dr. Dobb’s is discussing 

phone systems. Well, the private 
area branch exchange (PABX) is now a 
prime candidate for use as a local area 
network (LAN) for computer connec- 
tions. Let’s take a look at what a PABX is 
and see if the PABX is really the LAN of 
the future or simply a way to get rid of 
some wire in a building. 


What’s a PABX? 


The PABX is a local telephone sys- 
tem usually limited to a building, office, 
campus, or geographical area. Its purpose 
is to replace the ‘“‘expensive’’ facilities of 
the telephone company with equipment 
owned or leased by the business itself to 
save money and improve communications. 
PABX systems are provided by common 
carriers such as the local Bell Telephone 
system or by independent suppliers such 
as Northern Telecom, Intecom, and 
others. Offices acquired PABXes because 
of a need to communicate within an 
organization without sending all calls 
through the local telephone system’s 
central office switching facility. 

State-of-the-art PABX systems have 
a number of distinguishing features that 
make them prime candidates for data 
movement media. One such feature is the 
digital nature of the switching facility. 
When you pick up the receiver on your 
digital telephone and ‘dial’? a number, 
a connection is made at the PABX by 
routing the call through a digital switch- 
ing circuit, usually via a time-division 
multiplexing matrix switch. When you 
talk, your voice is converted from an 
analog signal into a digital signal at a 
voice transmission rate of 32K or 64K 
bits per second. If the connection is 
within the building or switching area of 
the PABX, the signal remains digital. If 
the connection is to an outside facility, 
i.e., for a long distance call, the digital 
voice signal is again converted to an 
analog signal and placed on the common 
carrier trunk (the wires of the phone 
company). 

Your digital phone set is an elec- 
tronic marvel (see Figure 1, at right). 





by Ted Rohling 





Ted Rohling, 4041 Medical Drive, San 
Antonio, TX 78229. 


It has a microprocessor built in to keep 
track of your speed - dialing numbers, the 
last number you dialed, and other features 
that are found on the friendly faceplate. 
It also controls the A/D conversion of 
your voice. Connecting your phone to the 
PABX are two pairs of wires: a power 
pair and a signal pair. The signal pair is 
used to transfer voice information and, 
in most cases, digital data traffic as well. 


The Computer Connection 
Every communications network has a 
topology, that is, the way the wires are 


connected together. The PABX uses a star . 


network, one where stations are con- 
nected in radials from a central point of 
control (see Figure 2 on page 61). The 
first telephone system was one of the first 
star-configured communications  net- 
works. Then the mainframe computer 
came along and adopted the same struc- 
ture for its computer-to-terminal con- 
nections. In fact, one of the first uses of a 
PABX as a LAN was in a mainframe/ 
terminal interconnect. Why is the PABX 
a better solution than those available in 
the past? 3 

For one thing, utilizing the PABX as 
an interconnect device gets rid of all of 
the twisted-pair wire that is usually 
strung around the building for data traf- 
fic. Simply add an RS-232 or RS-449 
connector to the back of the phone set, 
include more logic in the phone and the 
Switch used to handle the data traffic, 
and connect your terminal. Now you can 
use your phone to dial a computer con- 


nection. The PABX is also connected to 
the computer terminal port so that a 
“‘conversation”’ can take place between 
the terminal and the computer (see 
Figure 3, page 62). 

Using the PABX also reduces the 
number of terminal ports required on the 
mainframe or minicomputer. Computer 
users are like phone users: not all of them 
use the computer all day. In a large office 
a limited number of outside telephone 
lines are usually shared by all of the 
workers. Those people that need to have 
regular outside access usually have a dedi- 
cated phone line for themselves. This 
keeps down the cost of the telephone ser- 
vice. The same applies to computer con- 
nections. In most installations casual 
users come and go; their hard-wired con- 
nections are wasted for a given part of 
the day (see Figure 4 on page 62). By 
connecting a certain number of terminal 
ports for casual users through the PABX, 
you can reduce the port configuration 
(see Figure 5 on page 63). When the user 
dials the computer, the PABX looks for 
the next available port and makes the 
connection. When a terminal is discon- 
nected, a port is freed for other users to 
access. 


The Micro Connection 


LANs typically move data from one 
point to another using some common 
communications capability. The network 
allows the data to be looked at as either 
complete files that are moved around 
from workstation to workstation for pro- 





Figure 1. 


Microprocessor Controlled Digital Phone 
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PABX as a STAR Network 









C” LANGUAGE Seamed 
APPLE: AZTEC C-Full, ASM $199 call 
8080: BDS C-Fast, popular 150 125 
8080: AZTEC C-Full 199 call 
780: ECOSOFT-Fast, Full 250-225 
8086: C86- optimizer, Meg 399 call 
8086 _Lattice- New1.1&8 2.0 600 495 













































MicroSoft (Lattice) MSDOS 500 Call 
Digital Research - Megabyte 8086 350 280 
Desmet by CWare-Fast 8086 109 99 














BASIC ENVIRONMENT 


Active Trace-debug 8080/86 $ 80 73 
MBASIC-80 - MicroSoft 8080 375 $255 
BASCOM-86 - MicroSoft 8086 395 2/9 








































CB-86 - DR: CPM86/PC 600 449 
PBASIC - DRI 8086 150 119 
Business BASIC-MicroS MSDOS 600 449 
EDITORS Programming 








BELLESOFT - PASCAL MSDOS $245 — call 
C Screen Editor - 



















































source 8080/86 NA 60 
EDIX PCDOS 195 149 
FINAL WORD 8080/86 300 225 
MINCE CPM,MSDOS 175 = 149 
PMATE - powerful CPM: ©. 195° --475 


8086 225 195 
VEDIT - full, liked CPM, PCDOS 150 119 
8086 


200 =159 
SERVICES 


* Programmer's Referral List * Dealer's Inquire 
* Compare Products * Newletter 

* Help find a Publisher * Rush Orders 

* Evaluation Literature * Bulletin Board 
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PASCAL MT+86 
without SPP 

MS PASCAL 86 - 

ALCOR PASCAL full w/ 


ENVIRONMENT PRICE PRICE 


PHILOSOPHY: We carry every programmer's product for CPM80, MSDOS and CPM86 plus every key product for APPLE, Commodore 64, ATARI and TRSDOS. 


ASSEMBLER 


MAC/65 - macros, fast 


LIST OUR 


CPM86 $400 $295 
CPM80 350 =. 259 
MSDOS 350 280 

8080 250 call 


MACRO-80 - 


right extensions to learn RASM 


SBB PASCAL-great.fast PCDOS 350 315 
PASCAL 64 - nearly full COM 64 99 89 


UCSD PASCAL Compiler UCSD-PC 375 call CPM-86 


LANGUAGE LIBRARIES 


C_to_dBASE - interface 
C TOOLS - Graph, Str, 
FLOAT87 - Lattice, PL] 
GRAPH:GSX-80 
HALO 
ISAM: Access Manager-86 
PHACT - with C 
FABS 
PASCAL TOOLS 
SCREEN: Display Mgr-86 


PANEL-86 - many PCDOS NA 315 


WINDOWS - AMBER 
FORTRAN 


MS FORTRAN-86 - MegabyteMSDOS $350 $265 
CPM-86 


SS FORTRAN-86 
FORTRAN-80 - ‘66 decent 
INTEL FORTRAN-86 












VISA 


Circle no. 57 on reader service card. 


8086/86 NA $95 
PCDOS. =sNA—s118 
PCDOS. ~=sNA—s 15 
cPM80 »=s«60.—(ité«é*CS 
PCDOS §=:150.— «125 

8086 400 300 
PCDOS NA 250 
cPM80 150 ~—«:135 
PCDOS NA 115 

8086 500 += 375 —Ss Power 


MicroTools 


PCDOS 295 call 


‘COBOL 
Level Il COBOL - High 
425 345 MS COBOL-86 
CPM80 500 350 RM/COBOL-80 
IBM PC NA 1400 RM/COBOL-86 


Call for a catalog, literature, comparisons, prices. Shipping $2.50 


per item purchased. All FORMATS available. 


THE PROGRAMMER'’S SHOP™ 


908-C Providence Highway, Dedham, MA 02026. 


617-461-0120, Mass: 800-442-8070 


COMPARE Products. GUARANTEES 


We research and specialize only in software for programmers of micros. If 2 product is unknown to you and we recommend it, then we take the risk. 


ORCA/M - Reloc., Macro APPLE 
RMAC, etc. (Prog. Util) 


OPERATING SYSTEMS 


“CPM86 Emulator’ 
MicroShell upgrade CPM 
“MSDOS Emulator’ 
“Multitasking PCDOS” 
QNX - real time UNIX 


| TOOLKITS 


C Helper - DIFF, Flow 8080/86 NA 115 


NORTON for 1.1 or 2.0 
NORTON Book with Disk 


Programmer's Toolkit 


CIS COBOL - no royalty pane 


800-421-8006 MASTER CARD 


cessing or as “‘phantom disk drives.” 
When using a LAN with phantom drives, 
you don’t have to move the complete file 
to your workstation to process it. You 
can use the file where it is located, re- 
trieving and updating records as if they 
were on your local disk devices. Certain 
networks utilizing coaxial cable and high- 
speed links can provide phantom drives. 

Microcomputers in a PABX LAN 
installation are normally used in a file 
transfer or an attached terminal mode. 
The connections between micros within 
the scope of a PABX are simplified when 
a digital switch is used. The modems are 
replaced by the digital phones, and the 
phone connection is made as usual. The 
advantage is that a micro can now be 
moved from location to location without 
dragging the modem around with it. 

Speed also is improved between 
800% and 1600%, depending on the 
PABX utilized: data rates of 9.6 kilobaud 
or 19.2 kilobaud are common, which is a 
big improvement over the usual 300- or 
12-baud modem used in dialup com- 
munications today. Moving a 20 kilobyte 
file at 300 baud under ideal circumstances 
takes over 11 minutes; at 9600 baud it 
takes about 21 seconds. These times 
obviously discard any disk I/O time or 
line error problems. 


Ad Changed 12/30/83 







LIST OUR 
PRICE — PRICE 


LOOKING FOR 


$80 $75 *Fortran Level H with no changes 
200 149 for PCDOS 

yy, 12g “COMMERCIAL TOOLS - COMM 64 
200 159 «ROAR Seas Coloru longs 


ADA - Janus CPM-80 $300 $259 
ADA - Janus with tools 


$60 $49 PCDOS 500 449 

NA 95 LISP - 1Q LISP - full, 

150 125 PCDOS 175 call 

NA 95 MAGIC/L - Intriguing 

239 179 CPM80 295 call 

650 call MODULA II - 8086 495 455 
MODULA li - PCode 


APPLE 495 455 
PL/1-86- DRI CPM-86 750 560 
PL/1-80- DRI 8080 500 369 


150-123, ASCOM 80 CPM80 «175159 


Bee CACHE/Q - Virtual Mem. 
ae CPM80/PC 225 «185 
NA 95  MITE/BYE 8086/86 200 179 
“Read CPM86" 
MSDOS NA 95 
LYNX - Overlay Linker 
= a CPMBO 250 215 
750 595  PLINK-86 - Overlay, Meg 
750 595 MSDOS 350 315 
950 745 MSDOS Debugger NA 135 
Trace-86 25 11S 










RECENT DISCOVERIES 
HIGHLIGHTED 


C Helper includes source in C 
for CP/ M80, MSDOS for a: 
DIFF, GREP Flowcharter, XREF 
C Beautifier and others. $115. 


Note: all prices subject to change without notice. 
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Is the PABX really a cost-savings 
approach to the local area networks? If 
a new installation is being developed, the 
answer is yes. Since today’s average cost 
per telephone station for a digital PABX 
installation is $1000, the addition of the 
digital data capability costs about the 
same as a low-cost medium-speed 
modem. However, to completely retro- 
fit an existing PABX with digital data 
capabilities simply for the LAN facility 
is not an economically feasible solution. 
Nor is the PABX a solution for small 





Phone 


A, 


LOTTI TTL, 


yY 
KS 


Digital 





businesses, compared to the relatively low 
cost of “‘key systems.”’ 


Conclusion 


Utilizing the PABX for a local area 
network in the microcomputer environ- 
ment is not an optimum solution for 
most installations. Other network capabil- 
ities, including those now being defined 
by IEEE 802 committees or those on the 
market such as ARCNET or ETHERNET, 
are more applicable to the microcom- 
puter world. However, for locations 





Digital 


Phone © 


ce 


Nm LZ 





Figure 3. 


where digital PABX facilities are avail- 
able, the users can now enjoy faster file 
transfers between their microcomputers 
and can connect their micro to the main- 
frame or minicomputer systems at much 
higher data rates. BB 


Reader Ballot 
Vote for your favorite feature/article. 
Circle Reader Service No. 196. 


 PABX:; as a Data Interconnect Device as well as Voice Carrier 


Required (full-time) 


Connections 


Casual User 


Connections 


Mainframe 


Figure 4. 
Typical Configuration 
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Reduced Mainframe Ports Through PABX Connections 





nct 


of AGe 


MODAL DTC 


Finally you can utilize the 

power of Forth with efficient performance. 

rol Modal DTC is an interactive, extensible Direct Threaded Code 

the & software environment. Forth applications execute 4-5 times faster when 

: loaded under Modal DTC. For example, Modal DTC runs the Forth Sieve Benchmark 

in 1.7 secs/pass on a 4MH Z-80 with no wait states! You get the performance of the fastest compilers in a 
sophisticated fourth generation environment. 





Package Includes: 








A File Management Functions A Documented Demo Package 

A Full-Featured Screen Editor A Detailed Operation Manual ‘Tl O cq es 

A Symbolic Debug Facility A Professional Support and Upgrade Policy. 

A Memory-Mapped Video A Assembler with Conditional Assembly and S Uy S t e Mm S 

A Forth Vocabulary Macro Capabilities 

A Conditionals in Open Code A Many Extensions Under Development. 

A Conditional Compilation | 3030 Tangley Ave. 
Houston, TX 77005 

Modal DTC/80 Release 1.1 for CP/M 8080/8085/Z-80 64K Memory. Available in IBM 8" (713) 660-7394 


and most 5.25” disk formats. Very fast video on Osborne and similar systems. Specify 
computer and disk format when ordering. Personal License $149. US. 


Available soon for CP/M-86 and PCDOS Systems VISA/MC/MO/COD 


Circle no. 46 on reader service card. 
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BASIC Language 
Telecommunications Programming 





his article addresses some aspects of 

the following issues involving com- 

munications to a remote host (main- 
frame) computer: 


© How to upload files to systems that will 
not let us install receive programs such 
as Modem7 protocol programs 


@ How to get BASIC to read the status of 
our microcomputer’s hardware 


The programs described in this article 
were developed to work with systems 
having these two limitations. First, we 
cannot install any programs on the host 
to help us communicate with it. The host 
is used, for example, as a mail drop or 
bulletin board system and only allows the 
computer to transfer ASCII text files; no 
binary format files may be transferred. 

Second, we must not overload the 
host computer. Just about every main- 
frame computer that has keyboard or 
teletype (TTY) ports expects data to be 
transferred into that port at the typing 
speed of a human being. We, however, 
want to force-feed data into such a host’s 
TTY port from our microcomputer; as a 
result, data will be lost when we overrun 
the ability of the host computer’s operat- 
ing system to absorb what we send. This 
sounds unbelievable, but it has occurred 
on every one of the dozen or so different 
mainframes we have tried this on. Some 
of these famous brands could not even 
accept data at a continuous rate of 300 
baud (30 characters per second). 


Echo Handshaking 


The cure for all this is to sense the 
presence of an echo character coming 
back from the host and to use that to de- 
termine the timing of the whole system. 
This is called echo handshaking. This 
method is not limited by the baud rate 
of the modem being used: the transmis- 
sion and echo times dominate the trans- 
mission speed. 

The sequence goes something like 
this. Using some software means to direct- 
ly connect our keyboard with the host 
through the printer/modem port, we pre- 
pare the host computer to accept data 
and to transfer it to a file in the host 


by R. S. Broughton 





Robert S. Broughton, P.O. Box 5191, 
Beaverton, OR 97006. 


computer. We then start the echo hand- 
shaking communication program. The 
program sends the first character of the 
file up to the host and waits for the host 
to echo the character in normal full- 
duplex operation. When the program de- 
tects a returned character, it sends the 
next one, and so on until the entire file 
is transferred to the host. When the pro- 
gram is finished, we connect directly to 
the host again and terminate the trans- 
mission by whatever means the host 
wants. 


Channel A, printer (LST:) port 


Channel B, termina! (CON:) port 


We use the TELNET program, avail- 
able on older BDS ‘C’ distribution disk- 
ettes, for the direct connection from 
keyboard to host through the CP/M LST: 
port on the microcomputer. This well- 
done piece of software allows the easy 
downloading of files from the host to the 
microcomputer. 

The concepts in the BASIC programs 
shown in Listings One and Two (page 66 
and 67, respectively) could be inserted 
into the TELNET program, but because 
we communicate with a wide variety of 


1/0 READ PORTS: 


DATA STATUS 


81h 


83h 


Figure 1. 
1/O Register Addresses 





Z80—SIO Receive Port Status Register: 


Where the individual bits are defined as: 


D7 — Break Abort 

Transmit Underrun/EOM 
Clear To Send 
Sync/Hunt 


D6 — 
DS — 
D4 — 


D3 Data Carrier Detect 

D2 Transmit Buffer Empty 

D1 Interrupt Pending 

DO Receive Character Available 


Figure 2. 
Z80—SIO Status Register Description 
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host computers, we felt that a separate 
program for each protocol would suffice. 
We use these programs on a Cal-Tex 
BigBoard II microcomputer. 

The program shown in Listing One 
will communicate with most Unix com- 
puter systems and bulletin board systems. 
For other computer hosts such as Hewlett- 
Packard (H-P) computers, however, a 
slightly different protocol is used. A pro- 
gram that uses this different protocol is 
shown in Listing Two. 

The H-P computers allow data to be 
entered by using one of several editor 
programs (e.g., EDIT2 or EDITOR) 
after placing the program into insert 
mode. The protocol for these editors is 
slightly more complex than editors typi- 
cal of the Unix systems. When in insert 
mode, the H-P editors send out a prompt 
for each line, which includes the current 
line number. This prompt ends with a 
control-Q (X-ON), which is the signal to 
begin entering the next line. After send- 
ing the carriage return for the line, the 
program in Listing Two discards charac- 
ters received from the H-P host until the 
control-Q is received. The characters 
discarded are the prompt for the next 
line. The next line is then sent, character 
by character, each time waiting for the 
echo of the preceding character until the 
next character is sent, and so on. 


Discussion 


Since the programs are very similar, 
we will examine only the version for Unix 
computers in Listing One. The comments 
within the version for H-P computers in 
Listing Two should explain the protocol 
differences between the two. The state- 
ments are listed in Table I (below). 

Statement 450 reads a byte from 
register 129 (decimal) or 81 (hex) by 


100-130 Initialize the environment. 


140-170 Enter dialog with user to 
gain the filename to transfer 
and open it as an input file. 


200-360 The main body loop of the 
program. 


370-400 Report statistics of the file 
transfer to the user and 
determine whether another 
file transfer is wanted. 


450-470 A subroutine that checks 
the status register of the 
serial |1/O device and reads a 
byte of data from the data 
register when a character 
has been received. 


Table | 
Statements 





using the INP instruction. The AND 1 
instruction masks or turns off all bits in 
this byte except for the low-order bit; 
on the BigBoard II microcomputer using 
the Zilog Z80-SIO serial I/O chip, this bit 
is the data-ready bit in the status register 
of the SIO. Statement 450 will loop on 
itself as long as this bit is a zero, which 
means no characters have been received 
by the serial I/O device. When a character 
has been received by the serial I/O unit, 
this status bit goes high, returning a one 
and allowing control to pass to the next 
statement. 

Statement 460 reads a byte from the 
data register of the Z80-SIO chip. The 
AND 127 statement masks or turns off 
the top bit of the byte just read, yielding 
a single 7-bit ASCII character into X$. 
This character will ultimately be displayed 
on the CRT of the local microcomputer, 
letting the user know what is being trans- 
mitted. 

We don’t have to do anything special 
to send data out the printer port to the 
modem; we just use the LPRINT state- 
ment that Microsoft BASIC provides. For 
reading the echo back from the printer 
port from the modem, a more compli- 
cated method is required. As you can 
imagine, very few systems would antici- 
pate the desire to read data back from a 
printer. 

No matter, most systems use a Serial 
I/O device that has both a transmit and a 
receive section, and both sections are 
probably connected to the appropriate 
serial printer port. For our communica- 
tion purposes, the serial printer port is 
connected to a modem and the modem to 
the telephone line. Discussion of the 
modem connection is beyond the scope 
of this article. 

The BigBoard II microcomputer uses 
the Z80-SIO serial I/O chip for all serial 
I/O, both to/from the console terminal 
and to the printer. This discussion gener- 
ally applies to other serial I/O chips or 
USARTs in use (i.e., the i8251, ns8250, 
etc.). In this particular configuration, I/O 
read address 80 (hex) is the I/O read 
address for channel A or the printer 
(LST:) port, with 82 (hex) being the I/O 
read address for channel B or the terminal 
(CON:) port. This is summarized in Figure 
1 (page 64). The bits in the status regis- 
ter are described in Figure 2 (page 64). 

What interests us here is bit DO, 
which is a one when a character has been 
received, indicating we are ready to read 
from the receive data register. So we loop 
on this bit until it turns from a zero into 
a one, at which time we read the character 
just received at the receive data register of 
the SIO. 

As an example of how these programs 
might be changed to conform to other 
serial I/O devices, the i8251 has its Re- 
ceive Character Available bit in D1, not 
DO. For this chip, you would AND the 
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yxy Screen and serial editor, 
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FORTH programmer, this is the 
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Shaw Laboratories, Ltd. 
24301 Southland Drive, #216 
Hayward, California 94545 
(415) 276-5953 


Circle no. 69 on reader service card. 








65 





status byte read with two in order to set 
all bits read from the status register of the 
8251 to zero (except bit D1). The IF 
statement here should test for << >2, not 
ae 2 

There are several possibilities for 
enhancing the ideas expressed here. 
Error checking could be performed by 
comparing the return echo character 
with the original character. If they 
are different, there was an error in 


transmission or reception. If an error is 
detected, send a backspace and resend 
the original character. Of course, you 
won’t know whether the error was in 
the link to the host or from the host 
to your microcomputer. To speed up 
transmission, try sending a space and 
then a backspace before each line so 
that transmission and echo can overlap. 
You'll also find that the techniques in 
this article will assist the direct transfer 


of data from one microcomputer to 
another, without a telephone modem 
hookup. Hopefully, these remarks and 
programs will be helpful to you as you 
telecommunicate with your microcom- 
puter. BB 


Reader Ballot 
Vote for your favorite feature/article. 
Circle Reader Service No. 197. 


BASIC Telecommunications Programming (text begins on page 64) 


Listing One 


REM "ToUnix" transfers data files to unix cpu running cat, 


printed 


from cp/m 


a ae a a ee eee 


‘no system carriage returns 


— ee ee ome ae ow Se eee a Oe we ee eee ee ae WE ae ce eee eee oe eee ee ee eee SE eee ee ee ee ee ee ee ee ee ee eee eee eee ee ee ee ee oe 


transfer "; 


‘open the input file 


=e eee oe oes ee ee oe eee wee nee ee ee ee ee en ee ee ee ee ee ae eo ee oe ue ee ee ee ee eee SE eee oe ee Se oe Se ee ee eee ee oe ee ee Se ee ee ee cee oe 


100 

110 REM 

120 WIDTH LPRINT 255 
130 TRUE=-1 

140 PRINT"ToUnix here" 
150 PRINT"Enter file name to 
160 INPUT FLS 

£70 OPEN EF"; 1, £55 

180 CHARS=0 

190 LINES=0 

200 IF EOF( 1). THEN. 370 


LINE INPUT #1,AS$S 


LINES=LINES+1 
A=LEN(AS ) 

CHARS=CHARS+A 
FOR I=l1 TO A 


GOSUB 450 

PRINT CHRS(X); 
NEXT I 
LPRINT CHRS(13); 
GOSUB 450 
IF X<>10 THEN 320 


IF LEN(AS)<l THEN AS=" " 


"check for end of input file 
‘read next line from input file 


‘count statistics 


‘count statistics 


‘if a null string send a space anyway 


"for all the characters in the line 


LPRINT MIDS(AS,I,1); 


"wait for echo back from unix computer 
'display it on the terminal 


"send the carriage return to end the line 
"wait for character received from modem 


‘line feed received, 
“one more Tine sent 


the prompt for next line 


"get next line from input file 


— ee eee ee ee ee ee ee ee ee ce ee Ee ee ee ee ee ee cee cee ee eee ee ce ee ee ee ee eee ce ee oe ee 


"print statistics of the transfer: 


340 LINES=LINES+1 

350 PRINT 

360 GOTO 200 

370 CLOSE 

380 PRINT 

390 PRINT "File transferred" 
400 PRINT CHARS;" 


PRINT LINES;" 


Characters transferred" 
Lines transferred" 


ee ee i ae 
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420 


430 GOTO 150 


440 


PRINT CHRS(7);3 "beep to operator that transfer is completed 
'get next file to transfer, if any 


END 


oe ee ee ee ce ce ee ce ee oe cu SD SR eee OR cee See ee ee ee ee ee ee ee ee ee ee ee ee oe ee eee eee ee ee Gm ae com oe oop 


450 IF((INP(129) AND 1) <>1) THEN 450 'wait for data to read back 


460 
470 


X=INP( 128) AND 127 
RETURN 


‘'readback the echo from the host computer port 


End Listing One 


Listing Two 


100 
110 
120 
130 


140 
150 
160 
170 
180 
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REM "“"ToHP" Transfers text files to H-P computer running edit2, fromcp/m 
REM PILI eteba ates Ak A ar SS 
WIDTH LPRINT 255 ‘no system carriage returns 

TRUE=-1 


PRINT" TOHP HERE" 
PRINT" ENTER FILE NAME TO TRANSFER "3 


INPUT FLS 
OPEN’ *I*,1,FL$ 
CHARS=0 (Continued on next page) 
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pays for itself with the first recovery. Even more, Disk Inspector 
allows you to use the Auto-Load feature of CP/M, blank out bad 
sectors, create multiple entries, small files, all without any knowledge 
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BASIC Telecommunications Programming 


Listing Two (Listing continued, text begins on page 64) 


190 IF EOF(1) THEN 350 
200 LINE INPUT #1,AS$ 
210 


220 LINES=LINES+1 


230 A=LEN(AS ) 


240 CHARS=CHARS+A 


"check for end of input file 
'read a line of data from input file 
IF LEN(AS)<l1 THEN AS=" " ‘if a null string then send a space anyway 


‘how many characters are in this line 


A DR DARE OE ee EO SE OR EE SS eek Se SES eee ee 


245 LPRINT CHRS$(17); 

250 FOR I=l1 TO A 

260 LPRINT. MIDS. CAS, 1,1); 
270 GOSUB 430 

28 0 PRINT CHRS(X)+; 


290 NEXT I 


300 LPRINT CHR$(13); 


"send leading control QO... 

"for all the characters in the line 

'send the next character in the line 
'wait for echo back from the H-P computer 
‘display the echo on the local terminal 


'send the carriage return to end this line 


me ene ee EE et EE EE EAS ee EE ee ee ee RED RO ee ee Le ae Gee EE ewe oe 


310 GOSUB 430 
320 -IF X<>17 THEN’ 310 
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'wait for character to be returned from modem 
‘discard characters until the control QO prompt 
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ess cow =e ee eee aoe Se oe eee ae eee es aoe aon ee we ee ee 2 ee ore eee re ee ee ee ED De re ee ee Dee ee ee oe ee ee ee oe eee me <a we 


330 PRINT ‘local carriage return 


340 GOTO 190 "get the next line, if any 
350 CLOSE ‘all done with this file, 
360 PRINT ‘report status and statistics to user 


370 PRINT"FILE TRANSFERRED" 

380 PRINT CHARS;" CHARACTERS TRANSFERRED" 

390 PRINT LINES;" LINES TRANSFERRED" 

400 PRINT CHRS(7);3 

410 GOTO 150 ‘try to get another file to transfer 
420 END 


— ee OD OD FER ee ee ee ee A Se ee ee Se eee ee ee ee ee ee ee ee ee ee ee ue ee ee 


430 IF((INP(129) AND 1) <>1) THEN 430 'wait for data to echo back 
440 X=INP(128) AND 127 "'readback the echo from the H-P computer port 
450 RETURN 


End Listing 
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U.S. Robotics S-7100 Modem 





We found this 1200-baud S-100 plug-in 
modem very interesting — it’s the only 
one we know of. We reserved detailed 
examination of the product for an up- 
coming review, deciding instead to let 
’ someone intimately associated with the 
product give you a look at the process of 
its creation. — Ed. 


bout ten years ago I used my first 
A modem. It was a large gray box in a 

drawer of a special desk holding an 
IBM Selectric-type terminal. This modem 
communicated with a large mainframe 
computer at the lightning speed of eleven 
characters per second. Since this replaced 
punched cards, the slow speed did not 
seem so bothersome. But one day a thirty- 
character-per-second modem was installed: 
this was high speed computing. 

Ten years later, I am sitting at my 
own computer with a modem installed in 
the machine and I can communicate with 
other computers over the telephone net- 
work at over 120 characters per second. 
I never thought I would own a computer, 
let alone work for a company that manu- 
factures modems. 

The last ten years (for data commu- 
nications, the last two or three) have seen 
tremendous advances in telecommunica- 
tions software and hardware. Today, both 
the computer and the modem are priced 
within the reach of the average computer 
user. 

Less than a year ago, U.S. Robotics 
decided to redesign the Autodial 212A 
unit which was the top of the line 
product produced by the company. The 
main goals of that effort were to produce 
a smaller, less expensive product and a 
simpler-to-use modem. This product 
would help to make 1200-baud intelligent 
modems more available to the average 
computer user. 

Most of the auto dial units then on 
the market looked like many of the early 
home computers. They included many 
lights and switches. The average modem 
user, like today’s average computer user, 
usually needs an on/off indicator and an 
on switch to turn the unit on and off. 
The lights are useful for real technicians, 


by Michael MckKillip 


Mike McKillip, U.S. Robotics, 477 E. 
Butterfield Rd., Lombard, IL 60148. 


but most people could care less. 

In addition to the simpler user inter- 
face, the design team developed the con- 
cept of a core modem. The core modem 
circuitry contained all the electrical mo- 
dem elements for accepting TTL-level 
digital signals and producing analog signals 
necessary for telephone transmission. By 
adding a power supply, RS232 interface, 
and other circuitry, this product could be 
customized for other equipment manufac- 
turers or made into specialized products. 

Several of the members of the engi- 
neering team were long-time users of 
S-100 systems. After the production of 
the Password, the new redesigned modem, 
the attention of several people turned to 
other products to incorporate the core 
modem concept. Among the first was the 
S-100 modem. Although there were sev- 
eral S-100 modems available, there were 
no intelligent 1200-baud modems for 
S-100 computers. 


Advantages and Disadvantages 
of the S-100 Modem 


The S-100 card modem presents 
several advantages for the user. For peo- 
ple like me there is the question of space. 
A card modem is integral to the computer 
and does not take up any of the work 
area around the computer. 

Cables, it seems to me, are the 
Gordian knot of computer owners. For 
most modems, at least three cables are 
needed: power, telephone line, and RS232 
connector. The power for the modem 
comes from the S-100 bus, so there is no 
adaptor to plug into an already over- 
crowded power strip. Communication be- 
tween the modem and the computer is 
over the S-100 bus which eliminates the 
RS232 cable. The S-100 modem requires 
only the telephone cable. 

The elimination of the RS232 inter- 
face also removes the problem of cabling 
between the modem and computer. Re- 
moving the necessity for an external 
RS232 cable also eliminates the need to 
use one of the serial ports on the comput- 
er for communications. 

Today many of the modems on the 
market are intelligent modems. These 
modems are much simpler to use than 
many of the earlier models. For the most 
part they are controlled by commands 
sent over the serial communications line. 
Commands may be incorporated to dial 
numbers, turn on and off speakers, send 
result codes, and numerous other func- 


tions. The commands provide a means for 
software control of all the modems’ func- 
tions. In terms of control, the S-100 
modem is the ultimate intelligent modem. 
There is no on/off switch; it is a fully 
integrated part of the computer. 

Systems developers or integrators can 
develop programs which can establish a 
communications link without the user of 
the system ever knowing the telephone 
number dialed or log-on sequences re- 
quired. This is possible through the use of 
the autodial function and direct input/ 
output over the S-100 bus. Sophisticated 
users may be able to circumvent such 
techniques. 

There are some disadvantages to the 
S-100 modem. Since it is not a separate 
unit, it cannot be easily moved from one 
machine to another like a stand-alone 
unit. It may be slightly more complicated 
to install the S-100 modem for the sim- 
pler types of communications. Most sys- 
tems provide some driver routines for 
serial communications devices, but the 
S-100 may require user-written driver 
routines. 

The decision to use an external mo- 
dem or an integrated modem depends on 
the needs and preferences of the user 
more than on the units themselves. 


The S-100 Modem Design Process 


The design team started with the 
core modem, which they now refer to as 
‘‘essence of modem,”’ and began to design 
a card modem for S-100 systems. One of 
the first factors taken into consideration 
was the S-100 standards. The design team 
had had experience with S-100 cards in 
the past and knew the troubles with non- 
standard cards. The first requirement of 
the new design was that it be compatible 
with the new IEEE 696 standard for 
S-100 systems. 

The bulk of the design work then 
centered on the serial interface. Several 
important criteria came into play when 
designing the interface. First was the 
availability of the parts to be used (were 
several sources available?); familiarity 
with serial interfaces (what experience 
did the designer have with the parts?); 
and simplicity of operation (would the 
user be able to operate the modem with a 
basic knowledge of S-100 systems? ). 

The 8251 USART (Universal Syn- 
chronous/Asynchronous_ Receiver/Trans- 
mitter) was chosen for the basic design 
because of availability of the part and the 
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design team’s familiarity with it. The S- 
100 card modem would operate as a fair- 
ly independent unit so that all timing and 
interface circuitry would be contained on 
the board. 

Since most S-100 systems are based 
on the 8080 or Z80 family of micro- 
processors, the input and output for the 
modem were ported rather than memory 
mapped. The current design provides for 
32 possible locations in the port addresses. 
S-100 standards provide for optional ex- 
tended addressing for 16-bit port address- 
ing, but this was not incorporated into 
the current design since 16-bit processors 
are currently more the exception than the 
rule. This will probably be changed as 
16-bit processors become more common. 

After the production of the basic 
specifications of the product, the first 
prototype was produced. This prototype 
incorporated the core modem and a wire- 
wrapped board containing the circuitry 
for the serial interface, speaker, and tele- 
phone lines. 

To test a prototype and debug a 
wire-wrapped board is good for the soul. 
If you haven’t done it, you’re missing a 
lot of fun. If you have, you know what 
goes on. The first step in the process is to 
turn off the computer and take out every 


card on the bus. Usually an extender card 
is placed in a slot and the wire-wrapped 
board placed in another slot. The proto- 
type card is then placed in the extender 
card. Carefully, you turn the computer 
on and keep one hand on the switch. As 
soon as the power is turned on, you look 
for smoke. If the prototype is “smoking,” 
you quickly turn off the computer. This 
may sound funny, but ask anyone who 
has tested prototypes and they can tell you 
about at least one new board that smoked. 

No smoke is the best thing the de- 
signer can hope for the first time a new 
board is powered up. If there is nosmoke, 
the board should sit in the system for 
about one hour or so with the power on. 
This provides a chance for any component 
which may have a problem to burn in a 
bit. After about an hour, each component 
is checked for heat. Usually a finger on 
the part is enough to tell if there is a 
problem. Then a volt meter and an oscil- 
loscope are applied to various circuits to 
check the voltage levels and pulses. Wire 
wrapping can result in bad connections 
that are tough to find. 

The S-100 modem only had two wire- 
wrapping problems the first time it was 
tried. The real problem with wire wrapping 
is the transient problem: sometimes the 


board will work and sometimes it won't. 
Trying to track that problem can be a 
hair- pulling experience. 

After the smoke test, the system is 
powered down and the other cards re- 
inserted. The system is turned back on 
and the new card tried for the first time. 
With the S-100 card, it worked the first 
time. Data sent to the serial interface 
went to the modem and it worked. Several 
days of testing did show some minor 
flaws in the wiring, but they were easily 
corrected. 


The next stage in the development of 
a new board is to have real circuit boards 
made. This requires developing a mask for 
photo etching and having cards actually 
printed. The S-100 card modem is a fairly 
simple design which requires only two 
layers (front and back of the card). The 
actual layout of the circuitry by a layout 
artist required about a week, and then 
about another week was required for the 
cards to be produced. The first real test 
of the product was in the printed circuit 
card. 

After the cards are returned, a visual 
inspection is made, the components are 
soldered into place, and the test begins 
again. The smoke test is repeated. If the 
modem passes this test, then the full test- 
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ing begins. Again, the S-100 modem re- 
quired only minor changes. Two of the 
printed circuit trails were too close to 
each other, and one trail was on the 
wrong side of the board. 

Correcting the problems was a sim- 
ple task, but to insure a quality product 
one more round of printed circuit proto- 
types was developed and tested. These 
passed the test and production of the 
product began. 

The chief designer of the S-100 
modem is a good engineer who hates to 
write. So the hardest part of the develop- 
ment for him was the manual. Each de- 
signer is required to write the prelimi- 
nary version of the manual which then 
goes through several revisions by the 
technical writing staff and the customer 
service staff before a version is sent to 
customers. After about six months, the 
version provided to customers is thor- 
oughly reviewed and revised based on 
customer service feedback. 


Design of the S-100 Card Modem 
The photograph in Figure 1 (page 74) 
is a picture of the U.S. Robotics S-100 
card modem. The S-100 modem may be 
divided into two functional parts: the 
modem and the serial interface. The 


modem is the functional equivalent of the 
U.S. Robotics Autodial 212A or Pass- 
word modems. It is a fully functional 
autodial/autoanswer modem which oper- 
ates at 0 to 300 baud and 1200 baud, 
according to the 212A protocol. (See 
below for more information about baud 
rates.) Instead of the RS232 connection 
between the computer and the modem, 
the S-100 communicates with the com- 
puter through the S-100 bus. Communi- 
cation with the modem takes place 
through the commonly used I/O channels 
of the 8080, Z80, and 8086 family of 
microprocessors. Serial communication is 
through a 8251 USART. 


The Modem 


The S-100 card modem is an intelli- 
gent modem with autodialing and auto- 
answering capabilities. The S-100 modem 
accepts commands over the serial inter- 
face in the form of ASCII text characters, 
numbers, and special characters. An 
example of a command is: 


ATDT 555-8989 
This command would autodial the tele- 
phone number 555-8989. Commands may 


be given to the modem for the following 
functions: 


Enter Answer Mode 

Dial 

Echo back characters 

Half / Full Duplex 

On/Off Speaker 

On/Off Result code 

Set Number of Rings Before Answer 


Change Disconnect Command 
Characters 


Set Wait for Carrier time 
Set Terse/ Verbose Response 
Use Extended Result codes 
Reset 


Once a communications link has 
been established, all information sent to 
the modem is passed over the communi- 
cation lines. The only command the 
modem will accept is the command to 
disconnect (+++). The +++ sequence 
must be preceded and followed by one 
second of no data transmission. The char- 
acter used as a three-letter sequence for 
disconnect can be changed by the user. 

The S-100 modem will also automat- 
ically switch between originate and answer 
modes. When answering the telephone, it 
will automatically select between high- 
speed communication and low speed. 
Codes are sent to the terminal device 
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indicating whether a high-speed or low- 
speed connection was established. The 
microcomputer can then adjust its own 
baud rate accordingly. 

The S-100 modem also contains a 
speaker (upper left in the photograph 
in Figure 1) which will indicate the sound 
of the dialing tones and provide informa- 
tion about the status of the connection as 
it progresses. Once communication has 
been established, the speaker will auto- 
matically turn off. The user has the op- 
tion to turn off the speaker by issuing a 
command. Although the speaker is con- 
tained within the case of the computer 
on the S-100 moden, it is generally loud 
enough to be heard through the computer 
case. 


Baud Rates 


The 212A communications protocol 
for modems provides for the transmission 
of data at 0 to 300 and 1200 baud. 600 
baud may be found among Remote CP/M 
systems and other bulletin boards. The 
S-100 card modem has been designed so 





that it can handle 600-baud communi- 
cations. 


Since the serial interface and modem 
are contained on one card with no exter- 
nal RS232 interface, some of the signals 
designed for use with RS232 may be used 
for other purposes. In this way, the Re- 
quest to Send line, sometimes used as an 
RS232 signal, has been used in the S-100 
modem to provide access to more baud 
rates. When programming the 8251, if the 
RTS line is set to low, the baud rate will 
be divided in half. In this way, 1200 baud 
may be switched to 600 baud and 300 
baud to 150 baud. 


It must be remembered that 600 
baud is really a fast 300 baud and not a 
slow 1200 baud. When a telephone con- 
nection is made, the protocol’s baud rate 
is determined by the sounds the two mo- 
dems make. These sounds follow a set 
pattern known as a protocol. The 300- 
baud and 1200-baud protocols are very 
different. Once a connection has been 
established at 300 baud, it is possible to 
change the baud rate to 600 baud at both 


Figure 1. 


ends and continue communications. Both 
sides of the connection must operate at 
the same baud rate or else garbage infor- 
mation will be received. 

The design team believed that the 
large number of RCPMs and the common 
set-ups for communications at 600 baud 
required the inclusion of 600-baud capa- 
bilities. 

The design process for the S-100 


‘modem from beginning to the time the 


first products were shipped required 
about ten weeks. One of the real joys of 
helping to develop a new product is to see 
it boxed up and shipped out the door. 
There are other advantages. The chief 
designer of the team has serial number 
lo of the modem hanging on the wall of 
his office and takes pride in showing it 
to visitors. Serial number two of the mo- 
dem is in the computer used to write this 
article and was used to send the copy to 
Dr. Dobb’s for printing. DBI 
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Reviewed by R. A. Langevin 


Friday! by Ashton-Tate is the son 
or, if you prefer, the daughter of dBase II. 
It provides most of the features of dBase 
II without requiring any knowledge of 
programming on the part of the user. In 
some respects Friday! provides capabili- 
ties that go beyond those of dBase II, 
since it permits users to custom design 
multi-line reports, create form letters 
with inserts from a data file, and define 
and print mailing labels — features not 
_ available in dBase II. 


Environments 


Friday! is available for a variety of 
current processor and operating system 
environments. These include 8080, 8085, 
and Z80 processors with CP/M 2.0 or 
higher and 8086 and 8088 processors 
with MS-DOS or CP/M-86. Memory 
requirements depend on the operating 
system used. A minimum of 64K is 
required for CP/M-80 and 128K for 
MS-DOS and CP/M-86. 

In a floppy disk environment, dual 
floppies are required with a minimum of 
126K available storage space. Friday! can 
also be used in a hard disk environment. 
A terminal or monitor that supports at 
least 80 columns and direct cursor ad- 
dressing is required. Any printer can be 
used as long as it supports line lengths of 
80 characters or more. 


Features 


Friday! is designed to support record- 
oriented files. A record can consist of up 
to 32 fields and can be up to 999 charac- 
ters long. There are no provisions for files 
that span two or more disks, so the maxi- 
mum file size that can be accommodated 
is limited by the space available on a 
single data disk. 

All interactions with Friday! are by 
means of an extensive set of nested 
menus: there is no integral programming 
language as with dBase II. As a result no 
programming knowledge or experience is 
required to use any of Friday!’s facilities. 
The menus support the design of a file; 
entry, updating, deletion, sorting, selec- 


tion, viewing, and printing of records; 
creation and printing of standard and 
custom reports; preparation and printing 
of form letters that include data from a 
selected file; and specification and print- 
ing of mailing labels. 

In addition to these impressive capa- 
bilities, Friday! data files are compatible 
with dBase II and Lotus 1-2-3 files and 
can be read or written to by WordStar. 
Since the format of Friday! files is well 
defined, users can access them using the 
facilities of BASIC, Pascal, C, and other 
programming languages, a capability that 
will not normally be required. 

After a file is designed, a standard 
Friday! data entry screen can be used ora 
custom-designed data entry screen can be 
readily produced with a series of screen 
layout menus. This is a useful capability. 
The user not only can design screens that 
are eSthetically more pleasing than the 
standard data entry screen, but more im- 
portantly can create a number of custom 
screens for a single file. Each screen can 
be designed to present only the fields 
desired, so that selected information in 
the file (for example, salary information) 
is hidden from the individual doing file 
updates. 


Two extremely useful features are 
available when creating or updating files. 
The first, a ‘“‘ditto”’ capability, premits 
the user to specify a field or fields that 
contain fixed information (for example, a 
date or a price). This fixed information is 
automatically carried forward to each 
record as it is entered or updated, greatly 
speeding up the process. The second fea- 
ture permits any field except the first to 
be a calculated field. Formulas for calcula- 
tion of individual fields can be up to 60 
characters long and have available a maxi- 
mum of 500 characters. More important, 
the values of calculated fields are saved in 
the data file being worked on! 


Reports can be created in two forms 
and the formats saved on disk. The first 
and simplest, the Quick Report, enables 
the user to specify the fields to be listed; 
give them titles that may differ from their 
internal names; specify their sequence 
across a report line; and print the corre- 
sponding report using up to 15 relational 
rules to select the records to be used. 
Although Friday! always maintains the 
records in a file sorted on the first field of 
the record, temporary sorts can be defined 
on as many as five fields for the produc- 
tion of reports. 

The second and more flexible report 


form, the Custom Report, permits the 
user to select the fields to be printed and 
to locate them anywhere on the page. This 
flexibility, not available in dBase II, 
affords the opportunity for considerable 
creativity in report layout. Since the Cus- 
tom Report format can incorporate any 
text whatever in addition to data from 
the records selected, it can also be used to 
create simple, single-page form letters, 
as well as be adapted to the creation and 
printing of mailing labels. 


Documentation 


Friday!’s documentation is among 
the best I’ve ever seen. Its 207 pages are 
attractively printed and bound in a sturdy 
three-ring notebook. The back of the 
notebook is hinged so that it will stand 
up on a desk. All in all, very attractive 
packaging! 

The documentation consists of a 
brief overview of Friday! and a series of 
six lessons that should be worked through 
at a terminal. These lessons will quickly 
teach anyone how to use all of Friday!’s 
features. The next section of the manual, 
almost 75 pages long, provides an exhaus- 
tive description of all the prompts that 
appear on the screen as Friday! is used. 
A glossary is also provided to help new 
users over the rough spots of terminology. 


A series of eight appendices and a 
good index conclude the documentation. 
The appendices describe Friday!’s sorting 
order, file naming conventions, relation- 
ship to dBase II, field renaming proce- 
dures, use of backup files, working and 
backup copies of Friday!, installation in- 
structions, and the use of Friday! with 
Lotus 1-2-3. After the index a handy 
reference folder summarizes Friday! com- 
mands and procedures. This is a docu- 
mentation model that others could well 
follow. 


Problems 


Unfortunately, nothing is _ perfect. 
There are a few things in Friday! that I 
would like to see changed. 


Although the user can create a cus- 
tom screen for data entry or update and 
can place fields anywhere on the screen, 
the sequence that the cursor follows as it 
skips through fields is the sequence in 
which the fields were originally defined in 
the record layout. While this is not a real 
problem, it can be disconcerting to see 
the cursor jumping around the screen. 

I consider the two built-in, unchange- 
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able default limits to be a more serious 
problem. Specifically, it is impossible to 
print a line longer than 160 characters, 
and the physical length of a page is always 
taken to be 66 lines. Many printers are 
capable of printing lines substantially 
longer than 160 characters, and the extra 
width can be extremely useful. It’s not 
clear why Ashton-Tate chose such a 
short line length as an upper limit. The 
built-in assumption of 66 lines per page 
can be lived with, but many times it is 
more convenient to print a report on paper 
that is 8% inches high and 11 inches wide; 
this is difficult to do with Friday!. 


Summary 

The foregoing criticisms aside, Friday! 
is a powerful file handling package that 
affords most of the capabilities that a 
user would normally want. Best of all, 
these capabilities are now accessible to 
the nonprogrammer. Friday! should do 
well in the marketplace. 


SAL/80 

Company: Protools, 24225 Summerhill 
Avenue, Los Altos, CA 94022 

Computer System: CP/M 2.2 

Price: $59.95 

Circle Reader Service No. 133 

Reviewed by Jim Kronman 


SAL/80 is a software package that 
adds standard “structured” control oper- 
ators to the 8080/85 assembly language 
and can also, at the user’s option, produce 
some code optimized with Z80 instruc- 
tions. SAL/80 is designed to be used with 
the Digital Research, Inc. MAC and RMAC 
macroassemblers. In addition to the con- 
trol structures, built-in library functions 
are provided. Newberry Microsystems 
refers to SAL/80 as a “language,” but it 
is actually a language enhancement, used 
in the same way as RATFOR is used with 
Fortran. 

Structured programming is a lot like 
religion: either you believe or you don’t. 
I will not try to sell you on the concept 
in this review, but if you believe in mini- 
mai use of GOTO, you will appreciate 
SAL/80. 

This review applies to version 2.1 of 
SAL/80 running under CP/M 2.2. The 
author of SAL/80 is Steve Newberry and 
it is marketed by Steve’s company, Pro- 
tools. The current price for SAL/80 in- 
cluding a 200-plus page manual is $59.95. 
The price includes a free update to ver- 
sion 3.0. SAL/86 is or will be available 
for 16-bit processors. 


What It Is 
SAL/80 provides these familiar con- 
trol structures: 


Our new Optimizing = C86" C 
Compiler controls 
Charlie... 


Like a Puppet 
on a String: = 


Take control of Charlie with 
our new Optimizing=C86™ .« 
C Compiler...now available for 
the IBM PC-DOS and the 
MS-DOS operating systems. 
Take the upper hand with: 






e Significantly faster and tighter code 

e Standard object module format, linkable 
with the MS-DOS linker 

e Compile time switch for big machine addressing 
(Programs can be as large as the memory you 
can afford!) 

e Compile time switch to produce in-line 8087 code. 
(We still provide our floating point package, too!) 

e Significant performance increases for our I/O 

library 

MS-DOS version 2.00 I/O library 

Many additional library functions 

Expanded manual with numerous examples 

Librarian for maintenance of MS/DOS libraries 

Optional assembly source output (It’s not 

NECESSARY to produce assembly source, but it 

CAN be assembled using MASM!) 


Pull Charlie’s strings with our new Optimizing = 
C86™ C Compiler. See your local dealer or call 
Computer Innovations for information and to 
order the C86 Compiler Diskette and 
Manual...still only $395.00! 


Computer Innovations f€ Fhey Say it All... 
980 Shrewsbury Avenue sam mt F Ant 
Tinton Falls, N.J.07724 Wwe Do It ° 

(201) 530-0995 





Visa and MasterCard accepted. 


C86 is a trademark of Computer Innovations, Inc. CPM-86 and MPM-86 are 
trademarks of Digital Research. MS-DOS is a trademark of Microsoft. PC-DOS is a 
trademark of International Business Machines. 


Circle no. 14 on reader service card. 
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DO/ENDDO 
FOR/UNTIL/STEP/ENDFOR 
IF/ENDIF/ELSE/ENDELSE 
LOOP/ UNTIL/ENDLOOP 
REPEAT/ENDREPEAT 
WHILE /ENDWHILE 


SELECT/CASE... 
CASE/ENDSELECT 


EXIT and GOTO are also provided. 

The control structures are supported 
by a wide range of boolean expressions of 
the form X,rel,Y where X and Y (with a 
few limitations) can be any register, regis- 
ter pair, memory reference, or constant. 
The ‘‘rel” in these expressions can be 
either the usual comparisons (such as 
greater than, equal to, etc.) or one of 
several CPU status flag conditions (e.g., 
carry set, minus, etc.) that require no 
argument (X and Y are null and the PSW 
is implied). For convenience, IFCALL 
and IFGOTO are provided to allow a con- 
ditional call and goto consistent with the 
other operations. 


The SAL/80 built-in functions in- 
clude register save and restore functions. 
Most of the built-ins are designed to facil- 
itate program-to-user interface via the 
console. 


Several SAL/80 library files are also 
provided on the distribution disk. They 
include block move, string search and 
comparison procedures, and multiply and 
divide. 

SAL/80 is designed to work in a 
8080/85 environment but optionally will 
generate Z80 code for relative jumps and 
the ‘““DJNZ” instruction in loops. 


Using SAL/80 

SAL/80 version 2.1 is implemented 
as a set of macros that must be invoked as 
““MACLIB SAL/80” at the beginning of 
your assembly language program. You 
include the SAL/80 instructions as part 
of your assembly language program code. 
When it is time to assemble the code, 
SAL80.LIB and any of the provided 
** LIB” files you have referenced must be 
on the same disk as your source code. 
You run MAC or RMAC and the program 
is assembled. 


SAL/80 Documentation 


The SAL/80 manual has four chap- 
ters and three appendices. The chapters 
are indexed. The compiler source code 
has its own index, this source listing plus 
its index taking 72 pages. 

Chapter One, ‘‘Overview of Essen- 


tials”’ explains the syntax, content, and 
use of SAL/80 in 45 pages. A generalized 
example of each construct or function is 
given in schematic form. For example: 


LOOP? 

[ < loop body > ] 
UNTIL? < bool expr > 

[ < more loop body > ] 
ENDLOOP? 


This example points out one feature I 
have so far not mentioned: all SAL/80 
instructions are terminated with “‘?”’. 

Chapter Two, ‘“‘Tutorial: Maintaina- 
ble Programs,”’ is a 31-page essay on soft- 
ware design using a real-life (if somewhat 
contrived) example. All of the steps from 
design concept to finished product are 
covered. 

Chapter Three, ‘Tutorial Worked 
Example: MEMTEST,”’ is the complete 
source code listing of the example used in 
the previous chapter. It includes its own 
index (for the program) and occupies 50 
pages. MEMTEST is a memory test pro- 
gram. 

Chapter Four is called ‘“‘General Ob- 
servations’? and talks about using MAC 
and RMAC and the application of some 
of the features of SAL/80. 


WORKMAN & ASSOCIATES 


112 Marion Avenue 
Pasadena, CA 91106 
(213) 796-4401 





i 
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ANNOUNCING SIM48 


e SIM48 allows you to load, trace, execute and save Intel 
8748/8048 software using standard Intel Hex files. 


@ SIM48 allows you to simulate all instruction operations, 
timer/counter operations, |/O operations, interrupt 
processing, reset execution, internal and external RAM 
and ROM. 

e SIM48’s command set includes load, breakpoint, 
assemble, list (disassemble), trace, call and execute 
commands (as seen in DDT and ZSID). 

@ SIM48 allows you to simulate all software operations of 
the 8748/8048, yet costs 1/20th of an In-Circuit Emulator. 

® SIM48 is CP/M compatible. Supplied on an 8" SSSD 
diskette. 

® SIM22 (for Intel 8021/8022’s) and SIM51 (for Intel 
8751/8051's) soon to be released. 


$150.00 SIM48 Manual 
Plus shipping and handling. 


N.Y. State residents add sales tax. 
Mastercard/Visa 


Jocical Systems 


6184 TEALL STATION 
SYRACUSE, NY 13217 
(315) 457-9416 


SIM48, SIM22, and SIM51 are trademarks of Logical Systems Corporation 
CP/M, ZSiD, and DOT are trademarks of Digital Research 


Bi eel 
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Circle no. 39 on reader service card. 


THE FILE TRANSPORTER 


If you own more than one machine, you know 
how difficult it is to move files between 

them. One copy of The File Transporter 

will move any file between CP/M machines. 
It'll even send to CP/M-86 machines! 
Requires matching ports (serial or some 
parallel) or modems. A very detailed 

manual is included. 


The File Transporter is $69.50. 


"A Primer on Pascal for CP/M Systems" 


Full of examples and suggestions to make 
learning Pascal easier. Contains both a 
disk and a detailed manual with a glossary 
and an error-correcting guide. 


NEW PRICE! Discounted from $79.50 to $64.50 


Disk formats include: 8", Apple CP/M, Osborne 
Xerox, KayPro, Monroe, and Otrona. Please 
request our new catalog. 


Circle no. 86 on reader service card. 
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Appendix A of the manual is the 
complete SAL/80 source code. The dis- 
tribution disk file SAL/80.LIB, however, 
does not look like the source code. It has 
been, in Newberry’s words, ““krunched”’ in 
order to save disk and TPA space. Appen- 
dix B lists the source code for the error 
trapping portion of SAL/80.LIB. Appen- 
dix C is a summary of SAL/80 commands. 


Performance 


SAL/80 does what it claims to do. It 
runs, has a few bugs, but is well supported 
by the author. I can only fault it for being 
slow. On the other hand, RATFOR is no 
burner with Fortran, either. Steve New- 
berry has recognized the speed problem 
with his MAC.LIB approach and is cur- 
rently preparing a preprocessor version of 
SAL/80 written in the C language. Pur- 
chasers of version 2.1 will receive version 
3.0 free when it is available. 


The code produced by SAL/80 is 
reasonably close to being as compact as 
the code you would produce if you coded 
in “‘pure’’ assembler. For example, a small 
menu-driven program I wrote with SAL/ 
80 to send set-up commands to a printer 
was 1.4K bytes, and a similar program for 
another printer from ‘“‘pure’’ assembly 
code was just under 1.0K bytes. Although 
some minor inefficiencies have been cre- 
ated in exchange for generality, SAL/80 
generates more compact code than any 
level language compiler I have used. I 
have not noticed any case where execu- 
tion speed has suffered. My experience 
with SAL/80 has been with business 
applications; if you are coding a real-time 
control application, however, you might 
encounter critical areas where fine tuning 
is required. The same would be true if 
you were coding in “‘pure’’ assembler. 


Most of the constructs work as you 
would intuitively expect them to from 
experience with higher level structured 
languages such as Pascal or C. I found the 
SELECT construct, however, more limited 
than its CASE counterpart in Pascal. 
SELECT/CASE. ..CASE/ENDSELECT is 
actually more like Fortran’s computed 
GOTO statement. The first choice (CASE) 
must be 0, then 1, and so on. This is stated 
in the documentation, but I had a hard 
time understanding what it meant, proba- 
bly because I wanted it to work like 
Pascal! Another enhancement that would 
have been nice is if the X,rel,Y operations 
(relational operators, rel) would accept 
the syntax “A” to represent 41 hex and 
so on (like CHR(A) in Pascal or the liter- 
als in standard Intel assembler code). 

I have not succeeded in getting the 
example program, MEMTEST, to run on 
my computer. I must admit that I have 
not given much priority to this and there- 
fore have not spent much time trying. I 
have had no substantial difficulty, how- 
ever, getting any of my own applications 
written with SAL/80 running. 


The only other operational criticism 
I can make is that the error messages are 
not always sufficiently clear to allow de- 
bugging without resorting to examination 
of a “.PRN” file with the macro expan- 
sions included. This might not seem like a 
big deal until the first time you look at 
such a file from SAL/80. Some of those 
innocent-looking constructs and built-ins 
can generate gobs of code! 


I have found no problems in the 
built-in and library functions supplied 
with SAL/80, but in some respects they 
are a reinvention of the wheel. My per- 
sonal preference is for a set of routines 
like Richard Conn’s SYSLIB functions, 
which are in the public domain. I find 
some of the SAL/80 procedure names 
(such as “‘compare$strings:’’) to be longer 
than necessary; I type a lot, but that 
doesn’t mean I like to do it. 


Evaluation of the Documentation 


When I originally ordered SAL/80, I 
was motivated to do so by the documen- 
tation more than by the program itself. I 
thought it would be an economical way 
to learn more about MAC and RMAC and 
to pick up a few new programming tricks. 
My aims were accomplished, but I feel 
the documentation could be improved in 
some areas. 

The manual is better than many. It is 
thoroughly indexed. In fact, I wish more 
software publishers would be as thorough 
as Steve Newberry has been in indexing 
his manual. 


The greatest improvement in the 
manual would be to provide a real, con- 
crete, illustrative example with the defini- 
tion of each command. This would go a 
long way toward making SAL/80 immedi- 
ately useful. I found I had to try each 
construct a few ways until I got clear in 
my mind what each function could and 
could not do. Some real examples accom- 
panying each function description would 
have saved me hours of time. 

Another welcome addition would be 
a simple, columnar quick-reference list of 
all reserved words and a compact quick- 
reference guide for the commands. I 
would like to see the commands, built-ins, 
and so on defined one to a page in the 
manual for ease of reference. 


Support 

I have nothing but praise for New- 
berry’s support of his product. | am 
somewhat reluctant to print constructive 
criticism about SAL/80 because he has 
been so responsive to past inputs (from 
me and others) I am reasonably sure that 
most of my criticisms will have been 
answered by changes in the documenta- 
tion by the time you read this review. His 
initial release of version 2.1 had some 
bugs in it, but it was released at a dis- 
count. In addition, anyone who reports 


a real bug receives a free update to ver- 
sion 3.1 for the effort (version 3.0 is 
already included when you buy 2.1). 
Corrections fixing the identified bugs 
have been mailed to users in a timely 
manner. 


Conclusions 


If you must do assembly language 
programming and want to generate more 
readable and maintainable code, then you 
should investigate Protools’ SAL/89. It 
has the potential to give you some of the 
advantages of the higher level languages 
while retaining the control and efficiency 
of machine-level programming. 


FILEBASE 

Company: EWDP Software, P.O. Box 
40283, Indianapolis, IN 40283 

Computer: 64K Z80 CP/M 

Price: $75.00 

Circle Reader Service No. 135 

Reviewed by Dennis Cashton 


The object of many user-written 
programs, as well as many purchased soft- 
ware packages, is the manipulation of 
data in one form or another. Quite often 
what happens to data is not exactly what 
you had in mind, and you wind up having 
to write some sort of fix-up program to 
massage the data. Or you have a data entry 
package, a prime example of one applica- 
tion that cannot stand alone, and want to 
write a program to handle the data after 
entering them. On the way to your 
accounting programs or customer file 
processing programs, you are bound to 
run into a need to sort, extract, globally 
change, or otherwise shift things around 
in a file. In all these cases, it would be 
nice to have a listing of the data as they 
came from your source file or after they 
are sorted. Well, it seems that the folks at 
EWDP Software havea pretty good answer 
to your problems. 

FILEBASE is an effective utility for 
performing many useful file handling 
functions. With its clean, no-frills, menu 
approach, the user can select to: 


1. SORT a file (no exclude or include) 
SELECT/EXCLUDE only (no sort) 
SORT with SELECT/EXCLUDE 


LIST record positions and fields (to 
screen or printer) 


ADD new fields to an existing file 

CREATE a new file 

APPEND data to an existing file 

WRITE a subset of fields to a new file 
In going through the manual for 


FILEBASE, the first thing I noticed was 
that the people at EWDP have gone to a 
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lot of trouble to make the documentation 
and the program very easy to use. They 
assume no prior knowledge on the part of 
the user, and you are led by the nose 
through every function. Examples are 
provided for each function described, and 
explanations for every example. 

It would be possible to load the pro- 
gram and use it without reading the docu- 
mentation, but some of the features that 
make FILEBASE such a versatile tool 
would not be obvious from the menus 
provided. One example of such a feature 
is the ability to sort on a last name within 
a name field by using the ‘‘L”’ suffix ona 
field number. You have the same capability 
to get at zip codes by specifying a ‘*Z”’ 
suffix. 

It’s little extras like this that make 
FILEBASE nice to use and especially 
suited for mailing list applications. In fact, 
the nice people at EWDP Software sent a 
draft of a brochure describing FILEBASE 
in such an application. Especially nice is 
the feature that allows you to set a pause 
between each record on printing, as well 
as the number of lines to skip between 
records and the tab position for start of 
printing. This makes it very simple to 
print envelopes. Other print controls 
make it easy to handle any size or shape 
of label, card, envelope, or paper. 

Other niceties include the ability to 
merge input files and to create multiple 
output files from one or two inputs. 


Comparators for SELECT/EXCLUDE 
can be: 

EQ - equal to 

GT - greater than 

GE - greater than or equal to 

LT - less than 

LE - less than or equal to 


(now the good stuff) 


BT - between values 
LS - one of a list of values 
RR - range of record numbers 


Sort can be ascending or descending, and 
the number of fields that can be printed 
across the page depends on the specified 
printer paper width. 

There are, as always, several cautions 
and catches to watch out for. First, the 
documentation I received was stamped 
“OUTDATED MANUAL — SAMPLE 
ONLY ’”’ and was for version 1.1. The disk- 
ette supplied was labeled Release 2, and 
an attached note stated that the Release 2 
manual would follow on publication. I 
can only hope the functional differences 
are not significant. 

The manual refers often to the use of 
““comma delimited fields,’ but this is 
standard for many data entry programs 
and most versions of BASIC. The use of 
files ‘“‘external” to FILEBASE is also 
stressed. All this means is that your input 
files will not be manipulated or destroyed 


by inadvertent bungling. In my many 
years of experience with inadvertent 
bungling, I consider this a definite plus. 

Unlike the common data base manage- 
ment systems, FILEBASE does not need 
to have fixed-field, structured records. It 
will actually read the file to find out the 
field types and lengths. 

FILEBASE has its limitations, but it 
is still more than sufficient for most 
applications. The limits are: 


Record length - 4096 bytes max 
Fields per record - 40 max 
Input files per execution - two 
Output files per execution - two 


Records for SELECT/EXCLUDE - 
15000 max 


Records for sorting - 4000 max 

File size — 240K max (more 
possible, but requires extra 
processing time) 

Numeric sort precision — 10 digits 


One interesting note: The manual 
says it needs 64K to execute, but it ran 
with no noticeable degradation on my 
52K CP/M system. 

I find it difficult to express how 
pleased I was from the moment I put the 
disk in and typed in FILEBASE to get it 
started. Everything worked as stated, if 
not better, and I instantly thought of 
a dozen things it would come in handy 
for. When you weigh utility against price, 
I don’t see how a person who deals with 
any kind of data files could do without 
this program. It is everything you could 
ask for, in documentation, function, and 
price. 


EWDP has informed us that Release 3 will 
be introduced at SOFTCON in New 
Orleans, Feb. 21-23. Enhancements in- 
clude random access by user controlled 
indexing of any field and ability to 
select or exclude records by sub string 
searches, — Ed. 


Oubliette 

Company: Centaur Software, 501 
Jackson, Charleston, |L 61920 

Computer System: CP/M 

Price: $39.95 

Circle Reader Service No. 147 

Reviewed by W. James Wiggins 


Venturing down a dark passageway, 
you come to a doorway. Peering cautious- 
ly in, you see before you a large bronze 
dragon; he suddenly spies you and... 
the battle is on. 

This could easily be the scene in the 
adventure game called Oubliette. Accord- 
ing to Centaur Software, Oubliette is 
French for dungeon or maze. The game 
follows the type of game made popular 
by TSR, the Dungeons and Dragons 


series — and follows it very well. 

This author has been addicted to ad- 
venture games for about two and a half 
years now and has played ‘“‘several,”’ 
those with graphics and those without. 
When Oubliette was given to me to review, 
I therefore felt confident that the game 
would be a snap to play, having had so 
much experience before with “‘games of 
this sort.’ I therefore sat down to play it 
without any more than a cursory stare at 
the artwork on the front of the very nice 
looking manual (after all, who reads 
manuals or instructions?). After wiping 
out my entire party (fortunately on my 
backup disk) I decided it might be good 
to at least look up some of the magic 
spells. Two hours later, I finally got back 


to the game... not because the manual 
was that hard to understand — it was that 
engrossing. 


Centaur documents not only why 
the world of Oubliette is the way it is, 
but they even translate the magical spells 
so that we lesser mortals can understand 
them. The manual flows well — there are 
charts and graphs clearly and succinctly 
comparing various races and classes; there 
are in-depth explanations on magical and 
clerical spells; there is even an almost 
complete map of the first level of the 
dungeon. 

The monsters, races, and classes will 
seem familiar if you have played Dungeons 
and Dragons before; the thrill of being 
able to run up to six characters by your- 
self and have the Dungeon Master be 
totally impartial will hook you on this 
game, though. 

The only drawback to the manual is 
the documentation of how to set the 
game up for your terminal. The disk in- 
cludes a program to help you configure 
Oubliette for your terminal, and unless 
you have a strange terminal like I do (I 
was playing it on an Apple II with a 
Videx 80-column card), you should be 
able to set it up for your terminal very 
easily. 

Now that I am an expert at the game, 
let me tell you the best way to play it. 
First, you need to build up your party 
and then...well, maybe I'll let you 
figure it out (maybe I will too). The one 
thing that I will tell you is that when I 
called and spoke to the people at Centaur, 
they asked how far down in the dungeon 
I had traveled. I admitted to going down 
to only the third level. They said that 
most people who went down farther 
seldom lived to tell about it. I wonder 
what’s down there? 

In case I haven’t given you a clue, the 
game is very good — realistic, engrossing, 
and well thought out. I would say that it 
is the most engrossing game that I have 
played in a long time. BB 
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BOOK REVIEWS 








C Programming Guide 

by Dr. Jack Purdum 

Published by Que Corporation 
$17.95, 250 pages. 

Reviewed by Dr. Joseph B. Rothstein 


Just a few years ago, programming a 
microcomputer in a high-level language 
meant one thing: BASIC. Now that pro- 
grammers can take advantage of micro- 
computer implementations of Pascal, 
Fortran, Lisp, APL, Forth, Ada, Cobol, 
and others too many to name, it appears 
likely that no language will again have the 
dominant position BASIC has enjoyed. 

But from this Babel of programming 
languages, a recent entry is making a 
strong bid for serious consideration in. the 
coming years. That language is C, a prod- 
uct of Bell Laboratories, the research arm 
of AT&T. 

Though C has developed a vocal and 
growing following among minicomputer 
users — particularly those working in the 
Unix operating system environment — it 
has only recently become available on 
microcomputers. 

The specification for C was published 
in The C Programming Language by 
Kernighan and Ritchie (published by 
Prentice-Hall, 228 pages). Any serious C 
programmer will eventually want to study 
it, but it includes only one chapter of 
tutorial introduction. Its terse, somewhat 
scholarly style is probably not appropriate 
for many microcomputer users, who have 
widely varying backgrounds and might 
want more introductory material. 

C Programming. Guide addresses this 
new group of potential C programmers. 
Purdum is the author of an implementa- 
tion of C for systems using the Z80 CPU. 
Though the Guide could serve as an intro- 
duction to any version of standard C, its 
style and approach are similar to other 
popular microcomputer programming tu- 
torials. 

In nine chapters, Purdum covers the 
syntax and use of C in an orderly, conver- 
sational manner using numerous example 
programs and program fragments. Because 
of its extensive set of operators and data 
types, learning C can be a challenge to 
those who have only used BASIC or For- 
tran. But Purdum’s incremental approach 
minimizes the difficulty, stressing hands- 
on experience of C and occasionally 
offering side-by-side comparisons of sim- 
ilar programs in C and BASIC. 

Most of the programs included in the 
text should run on any C compiler that is 


Unix version-7 compatible, so the reader 
with access to such a compiler can get 
immediate feedback by entering and 
testing the programs. 

Sometimes the text raises questions 
that can only be answered by running a 
particular program. The student is ex- 
pected to enter, compile, and run the pro- 
gram and observe its results. This approach 
may limit the usefulness of the book for 
those without access to a compiler. The 
preface mentions “‘two underlying assump- 
tions: (1) the only way to learna language 
is to write programs with it, and (2) learn- 
ing is made easier if you can visualize 
what a statement does,” so perhaps that 
was the author’s intention. 

While Purdum often suggests “‘play- 
ing around” with a particular statement 
or function, specific exercises (and solu- 
tions to selected exercises) would also 
be helpful. The student would then have 
the option of choosing the intuitive, 
exploratory approach or a more orderly, 
disciplined one. 


- Despite these concerns, the Guide is 
a worthwhile tutorial introduction to a 
powerful and versatile language. C has 
been called a “‘mid-level” language, offer- 
ing the direct control over machine archi- 
tecture which we normally associate with 
assembly language, while including a 
range of constructs and operations typical 
of high-level languages. Execution speed 
is comparable to assembler, with the 
important bonus that C was designed to 
be portable. Unlike assembly language 
programs, a C source file can be re- 
compiled to run on a variety of CPUs, 
generally with little or no change required. 
These features help make C an attractive 
language for systems programming — a 
fact that has not been lost on some of the 
biggest software houses, who are reported- 
ly writing more and more of their pro- 
gramming languages and utilities in C. 

In general, C programs consist of a 
series of functions, any of which may be 
placed into libraries and used again in 
other programs. The capability to develop 
and test a function only once, then use it 
freely without the need to modify or 
even test it, is one of the most attractive 
aspects of C. The text thoroughly and 
clearly explains the nature and use of 
functions, and how they are combined 
into complete programs. 

The index is thorough and easy to 
use, and appendices contain a syntax 
summary of C and a list of commercially 
available C compilers for microcomputers. 


Along with publishers’ names, addresses, 
and retail prices, Purdum offers brief 
comments including the degree of com- 
pliance. with the Kernighan and Ritchie 
standard. To his credit, Purdum avoids 
making his book an advertisement for 
Eco-C — his own version of the compiler. 
In fact, his association with that particular 
C compiler is not explicitly mentioned, 
and a comment describes Eco-C only as 
‘“‘a very nice implementation.”’ 

For all its importance to minicom- 
puter users, there are surprisingly few 
tutorial introductions to programming in 
C. Though C Programming Guide is no 
substitute for Kernighan and Ritchie’s 
text (nor was it intended to be), it may 
serve to introduce the microcomputer 
user to a powerful programming language, 
one likely to assume an increasingly im- 
portant position in the microcomputer 
world. 


Microcomputer Graphics 


Techniques and Applications 

By Donald Hearn and Pauline Baker 
Published by Prentice-Hall, Inc. 

$24.94 cloth or $19.95 paper, 302 pages 
Reviewed by Robert Ashworth 


This textbook is divided into fourteen 
major chapters dealing with almost every- 
thing a person would want to know about 
computer graphics on a small computer. 
Sixteen color figures showing the latest 
shading techniques as well as many black 
and white illustrations make this an infor- 
mative and enjoyable book to read, study, 
and even give to a friend for browsing. 

Hearn and Baker divide the book 
into five sections. The first four present 
an overview, the fundamentals of micro- 
computer graphics, and details on special 
effects and 3D. The fifth section contains 
program design, special techniques, sim- 
ulations, computer-assisted instruction, 
budget nutrition charts, and game playing. 
The 92 BASIC programs progress from a 
simple nine-line picture of of a fish to a 
180-line, three-page program. Each chap- 
ter concludes with several challenging 
projects for further programming. 

The approach is straightforward, logi- 
cal, and informative. The graphics com- 
mand conversion table in the appendix is 
very useful; it gives the equivalent graph- 
ics commands for the Apple, Radio Shack, 
and the IBM PC. This is an enjoyable 
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book to read and study, and it offers 
many varied illustrations to excite the eye 
and challenge the mind. 


Introduction to Numerical 

Computation in Pascal 

by P. M. Dew and K. R. James 

Published by Springer-Verlag, 
New York, Inc. 

$16.00, 291 pages 

Reviewed by Robert Ashworth 


The first part of this book focuses on 
Pascal with an emphasis on the funda- 
mental techniques needed to exploit the 
modular structure of the language. The 
authors have developed very readable 
code with particularly clear descriptions 
to show the results of quality mathemat- 
ical software. 

The central theme is a description of 
““mathlib”’ which is a collection of rou- 
tines available from the Editor of the 
Computer Science series of the publisher. 
These run under UCSD Pascal on the 
Apple II microcomputer. A_ ten-page 
summary of all the routines is given in the 
appendix. 

The authors take an algorithm or 
procedure for the solution of a given 
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problem and then show, step-by-step, 
how to make it more comprehensive, 
accurate, or efficient. Stress is placed on: 
stability, i.e., the algorithm is not sensi- 
tive to rounding errors; accuracy, i.e., the 
algorithm performs according to the 
documentation; efficiency, i.e., the algo- 
rithm is a function of time and memory 
required; robustness, i.e., the algorithm 
solves correctly the problem it was in- 
tended for; adaptability, i.e., the ability 
to move a program from one computer to 
another with a minimum of modification; 
error control, i.e., the need to have results 
correct to a specified number of decimal 
places; and the respective mathematical 
method of analysis. Part I concludes with 
a detailed discussion of errors and how to 
manage them on your computer. 

Part II explores the development of 
mathematical software. Different methods 
are given for the solution of nonlinear 
equations in one variable. The study of 
systems of linear equations is followed 
by different methods and an analysis of 
the strengths of each approach. Finally, 
the last two chapters deal with the fixed- 
point rules and the adaptive methods for 
numerical integration. 

The text meets the authors’ goal of 
covering core material in numerical analy- 
sis and methods for producing reliable 
mathematical software. Solutions are 






Circle no. 23 on reader service card. 


given for all exercises and four helpful 
appendices complement the well-designed 
text. It should be given a high priority for 
Pascal programmers. 


Automation of Reasoning 
Classical papers on computational 
logic, Vol. 1, 1957-1966; Vol. 2, 
1967-1970 

Edited by Jorg Siekmann and Graham 
Wilson 

Published by Springer-Verlag: Berlin, 
Heidelberg, New York, 1983 

$35.00 Vol. 1: 525 pages, Vol. 2: 

637 pages. 
Reviewed by Jay Halcomb 


These are the first two volumes of a 
planned series devoted to automated 
theorem proving. The volumes collective- 
ly contain 61 articles discussing mechani- 
cal theorem proving, which has applica- 
tions in automated program verification, 
program synthesis, and deductive data 
bases. The papers are of the highest quali- 
ty, selected by an international committee 
of researchers in the field, and include 
translations of previously untranslated 
literature. 

On the whole the papers are focused 
in scope, approaching computational 
logic in its strictest sense: the application 
of theories of first-order deduction and 
semantic methods to proof of mathemat- 
ical or logical theorems. A few of the 
papers allude to possible wider applica- 
tions, such as generalized problem solving 
and program verification, but the core 
concern is with theorem proving in logic 
and mathematics. In this sense the title 
and cover blurb are slightly misleading. 
However, for readers with professional or 
avocational interests in this field, the 
book is an excellent unified reference 
source. 

The volumes contain three historical 
articles especially useful to the new stu- 
dent or casual onlooker: 


Wos and Henkin: “Automated thoerem 
proving, 1965-70” | 


Davis: “‘The prehistory and early history 
of automated deduction” 


Maslov, Mints, and Orevkov: ‘‘Mechanical 
proof search and the theory of logical 
deduction in the USSR”’ 


Background 


The philosopher G. Leibnitz was per- 
haps the first to seriously envisage the 
possibility of algorithmizing and even 
mechanizing human reasoning. He pro- 
posed a calculus ratiocinator and lingua 
characteristica “‘to bring under mathemat- 
ical laws human reasoning, which is the 
most excellent and useful thing we have 
... the mind will be freed from having to 
think directly of things themselves, and 
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yet everything will turn out correctly.” 
But this vision lacked foundations until 
the growth of mathematical logic through 
the work of Boole, Frege, Russell, and 
Whitehead and the creation of recursion 
theory by Turing, Church, and Kleene. 

The subsequent implementation of 
these mathematico-logical theories in 
actual machines in this century brought 
the matter to a practical head. But until 
very lately enthusiasm and optimistic 
speculation have been more characteristic 
of the field than have actual results. How- 
ever, the recent announcement of a proof 
by computer of the famous four-color 
problem, a proof that apparently was not 
to be achieved in any other manner, es- 
tablished a substantial and important 
mathematical theorem, and the automa- 
tion of human reasoning began to come 
of age. 

Work on theorem proving in recent 
decades first concentrated, naturally per- 
haps, on the verification of known results, 
testing theories of problem solving rather 
than attempting new results. Thus in the 
late 50s the logician Hao Wang was able 
to deduce all of the theorems of Russell 
and Whitehead’s Principia Mathematica in 
a few minutes on an IBM computer. Later 
workers began attempting to formulate 
new results in the areas of group theory 
and model theory and achieved some 
noteworthy successes, establishing pre- 
viously unknown theorems of some signi- 
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ficance. But the crowning feat to date 
remains the aforementioned mechanical 
solution of the famous four-color prob- 
lem. 

Briefly, the four-color problem ques- 
tions whether four colors will always 
suffice for coloring any map on a two- 
dimensional surface. Much work was 
expended on this deceptively simple 
problem during the past century, but the 
general case remained elusive until the 
announcement in 1976 of a computer- 
assisted solution by Appel and Haken 
(“‘Every planar map is 4-colorable,” Buil 
Am Math Soc, No. 82, 1976). It should 
be noted, however, that this success relied 
on a prior ingenious reduction of the 
problem to a large but finite number of 
cases, which the machine searched as the 
“proof,” so the result is not unalloyed. 
This work is not discussed in the present 
volumes, due to its more recent date, but 
will doubtless appear in the next of the 
series. 


Schools of Automated Reasoning 


There are two general approaches to 
the simulation of reasoning by computers. 
One is the implementation of strictly 
deductive theory for a specific class of 
problems (such methods achieved the 
results mentioned above). The other is a 
heuristic, generalized, problem solving 
approach that requires the computer to 
generate “‘reasonable”’ search directions in 


problem solving, in this way emulating 
the human mind. This approach is associ- 
ated with the work of Newell, Simon, and 
Shaw, early pioneers in artificial intelli- 
gence (AJ). 

Lately we have come to see some 
amalgamation of these techniques. Al- 
though the availability of cheap memory 
and higher speeds, along with a sophisti- 
cation of inference rules, has greatly for- 
tified the deductive approach, a judicious 
use of heuristic rules clearly is also neces- 
sary to allow the computer to escape 
from an infinite drudgery of trivial com- 
putation. In 1961 Marvin Minsky, one of 
the AI leaders, wrote: “‘... it seems clear 
that a program to solve real mathematical 
problems will have to combine the mathe- 
matical sophistication of Wang with the 
heuristic sophistication of Newell, Shaw, 
and Simon.”’ 


Summary 


The present volumes concentrate on 
the deductive approach, perhaps justifi- 
ably since these techniques have so far 
yielded more substantial results. While 
Eliza-like programs are striking, they 
are not very sophisticated, either logically 
or heuristically. 

In summary these are not books for 
the general hardware hacker but are of a 
rather narrow academic interest. They 
shouid be welcomed by their intended 
audience. BB. 
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16-BIT SOFTWARE TOOLBOX 


by Ray Duncan 








PC-DOS Close Function 

I was tipped off to the first topic for 
this month’s column by an old COBOL 
programmer who had been trained to close 
every file in sight if execution of his pro- 
gram was terminated due to some error 
condition. When he tried to persist in this 
habit under PC-DOS, his files began to 
mysteriously disappear. They would still 
appear on a directory listing, but the file 
lengths were displayed as zero bytes and 
the CHKDSK utility was finding all sorts 
of ‘‘lost clusters”’ that it had to clean up. 

The problem turned out to be that 
PC-DOS is not checking to see if a file 
control block has been properly activated 
by a previous successful OPEN or MAKE 
call before carrying out the CLOSE 
operation. Apparently it just looks up the 
corresponding entry in the disk directory 
and copies in the zeroed-out file control 
block information, effectively destroying 
it. PC-DOS then gives the calling program 
back a return code indicating success 
(AL=zero). This is a really surprising bug, 
since there are several ways that the oper- 
ating system can quickly assess whether 
a file control block is valid or not. 

I have vivid memories of the recep- 
tion given to the poor soul who originally 
reported the IBM PC BASIC math routine 
errors, and also of the rather indignant 
letter previously directed to this column 
by the grandfather of PC-DOS 1.1 (Tim 
Paterson). Therefore, I am supplying a de- 
tailed example program in Listing One 
(page 85) that can be used to verify that 
this problem exists in both PC-DOS 1.1 
and 2.0. I haven’t had time yet to explore 
what happens when you ask for other 
disk operations (such as read or write 
record) with an unopened file control 


block, but I’m sure it will turn out to be 


most amusing. 


The Microsoft Assembler 


The Macro Assembler for the IBM PC, 
which was supplied by Microsoft, has 
come in for a little criticism from time to 
time because of its lack of speed and its 
appetite for memory, but it has escaped 
otherwise unscathed in all the magazines 
I read. Its performance and size can be 
attributed to the fact that it was written 
in Pascal (a more unlikely high level lan- 
gauge in which to write such a systems 
tool can hardly be imagined), and in spite 
of its handicaps it has been in the Softalk 
Top 30 month after month. 

Certain ‘“‘features’’ of the Assembler 
make me conclude that it was written to 


a set of specifications by a hotshot bunch 
of Pascal hackers who never even tested 
it, let alone used it for any kind of job in 
the real world. The first evidence for this 
is found in some bizarre listing notations. 
Although every assembler I have encoun- 
tered will show you the real value of an 
equate in the object code column of the 
listing, the Microsoft Assembler gives you 
a signed hexadecimal integer (see Listing 
Two on page 87, line 15). 

The authors of the Assembler also 
chose to ignore the byte-swapped nature 
of 16-bit values on Intel processors in 
their listing format. In line 21 of Listing 
Two, the byte at address 0000 appears to 
contain 00 while the byte at 0001 con- 
tains 01 — of course the reverse is what is 
truly found in the object code. Patching a 
program working from such a listing is 
unnecessarily confusing. 

But as long as we’re ragging on the 
boys at Microsoft, how about pointing 
out some really gross bugs. 

The SHL and SHR operators are not 
mentioned at all in the IBM version of the 
Assembler manual, except in a brief 
example on page 4-21 which states that 
101B SHL (2*2) should yield 01010000B, 
or SOH. From this you can infer that the 
SHL operator is used in the form “data 
SHL shift_count,’’ which in fact agrees 
with the Intel specification. Unfortunate- 
ly, no one ever checked the actual opera- 
tion of the Assembler against the example 
in the manual. By experiment, we find 
that the Microsoft Assembler expects the 
shift count first (see lines 29-37 of List- 
ing Two), in conflict with both the Intel 
and Digital Research 8086 assemblers. 

The SHR operator, on the other 
hand, behaves entirely unpredictably. In 
some cases it seems to act like the SHL 
operator, in others it doesn’t return any 
understandable result at all (see lines 39- 
ae oR 

Intel defines SHR and SHL as per- 
forming “logical shifts,’ bringing zero 
bits into the vacated positions. The 
Microsoft Assembler is inconsistent on 
this point (see lines 57-62). My guess is 
that the authors are ANDing the shift 
count with a mask of OFH, instead of 
testing for a shift count greater than 15 
which should return a zero result for any 
data. 

The logical operators EQ, NE, GT, 
GE, LT, and LE all perform erroneously 
as often as not (see lines 64-91). I sur- 
mise here that the operators are somehow 
ignoring the signs of decimal integers. 


Other than that, the operators apparently 
treat their arguments as unsigned 16-bit 
integers, a fact that is not documented in 
the manual but can be deduced from 
comparing hex values (for example, 
O7FFFH LT 08000H returns TRUE). 

The Not operator works for positive 
decimal integers and all hexadecimal inte- 
gers, but fails with strange results for 
negative decimal integers (see line 95 ). Si- 
milarly, the logical Inclusive Or operator 
gives incorrect results with negative deci- 
mal integers. 

Lastly, the Exclusive Or operator 
appears to work as an Inclusive Or instead 
(see lines 107-110). Don’t imagine for a 
moment that we have covered all the bugs! 
These were located in just a few minutes’ 
work, and I have been tipped off to others 
that should be good for several more DDJ 
columns. 

The moral of this month’s story 
seems to be: Avoid use of exotic or com- 
plex expressions, and perform any calcu- 
lations involving logical operations at run- 
time rather than assembly time. I had to 
laugh when I found the note on page 
D-14 of the Assembler manual that said, 
“In general, be careful when patching in 
hex.’’ Usually, this would be advice too 
obvious and banal to be worth the ink, as 
though someone were trying to say, “In 
general, be careful when jumping off a 
cliff.”’ But in this case, you are probably 
at least as safe patching in hex as you are 
in using the Assembler. 

Interesting side observations: Both 
the Intel assembler ASM86 and the Digital 
Research assembler RASM86 performed 
all of the operations in Listing Two cor- 
rectly. They also take up about half as 
much space on the disk as the Microsoft 
Assembler and run much faster. RASM86 
is now available for PC-DOS as part of 
the Digital Research ‘‘Programmer’s Utili- 
ties” package. 


Highly Recommended Software 


Those of you who like RAM-disks 
(and who doesn’t?) should consider the 
purchase of JETDRIVE for DOS 2.0 
from Tall Tree Systems in Palo Alto, 
California. The program is solid as a rock, 
works with any RAM expansion board, 
costs only $40, and is even supplied with 
source code. Also included is the JET 
utility which transfers files between disks 
at a rate guaranteed to astonish the most 
jaded programmer. If you thought the 
PC-DOS COPY function was fast com- 
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pared to CP/M’s PIP, you won’t believe 
JET. 

And for those small software houses 
wrestling with the problem of how to 
supply all the eighty zillion 5%-inch, soft- 
sectored disk formats, inexpensive relief 
is at hand. The program UNIFORM, from 
Micro Solutions in DeKalb, Illinois, can 
initialize disks and copy files to or from 


disks’ for some 40 different computers 
including such formerly difficult animals 
as the QX-10 and the Otrona. It will also 
transfer files between a CP/M disk and 
any of the MS-DOS single- or double-sided 
formats. UNIFORM currently runs on the 
various Kaypro models but is being ported 
to other machines. The best news of all is 
that UNIFORM costs only $50! At that 


price, it’s worthwhile to buy a Kaypro 
just- to use it—the alternatives are 
hideously expensive. BB 
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16-Bit Toolbox (Listing continued, text begins on page 84) 
Listing One 


45 , Except when it gives no result at ail... 
44 
? OOOE Ob1a de i shi & 
48 HO1n 0050 dw 1 shr & 
49 
ot) ; SHR may even give different results with equivalent data 
wi 
ny OO12 FRFF dw 1é shr -i 
3 O814 9600 dw 14 shr O¢ftth 
a4 
a : Sometimes the SHL operator seems to perform a “logical shift" 
ie 
37 GOL FFFE da 1 shl -1 
she O18 8600 de 13 shl -! 
39 
bp ‘ other times, it appears to perfora a circular shift 
di 
Z GOLA FFF dw {6 shl -{ 
&3 
b4 : The E@ operator doesn’t work properly 
43 
bb OO1G FFFF ou i eg | 
7 QOO1E FFFF dw 1 eq -i 
43 
4 : The EQ operator can give different results with equivalent data 
70) 
Tf HOZa FFFF du 1 eg ~i 
72 O822 O00 aw i eg Offtth 
73 
74 : The NE operator is similarly afflicted 
ie 
74 O024 0000 dw Ine ft 
72 0926 9000 di 1 ne -| 
7§ O02 FFFF du {ne Offfth 
73 
BO : The LE, LT, GE, and GT operators give confusing results 
Bi 
Re HOZA GOOG dw a ee 
om QG20 FFFF dw -i lel 
4 GNZE Oooo de =h gt: 4 
m 0030 FFFF dy -1 ge i 
B4 
BR? ; Again, these operators can give different rasults with 
é ; equivalent data 
85 
0 HO32 FFFF dw i ge -{ 
91 G034 G000 dw {ge O+fffh 
2 
33 ; The NOT operator fails miserably on some signed integers 
74 . 
95 OG346 G00? dw not -{ 
94 


i chi assis anism ss sincera spas 


86 


Dr. Dobb’s Journal, February 1984 





97 

98 

99 ; Similarly, the OR operator flubs with signed integers 

ite 

iat H038 oO01 dw -L or 9 

iO? OO38 FFFF di Offffh or 

1o3 

ii ; The XOR operator apparently works as an Inclusive OR 

13 ; instead of Exclusive OR 

$s 

ibs 

107 O30 o000 er O xor 6 

18g HOSE ogi dy [ xor 0 

iO? O040 0001 dw Oxor | 

11d 6042 9004 de i xor | 

iif 

149 s 48 
i12 end End Listing One 
Listing Two 

i ame CLOSE 

fi page aloe 

4 title ‘CLOSER - show bug in FC-DOS function 10H’ 
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1 6-Bit Toolbox (Listing continued, text begins on page 84) 
Listing Two 
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This program 
PO-DOS Close 


demonstrates a subtle but dangerous bug in the 
File function 10H. If a Close request is issued 
using a file control block that has not been previously 
activated by a successful Open command, the file’s length 

will be truncated to zero and the clusters previously assigned 
to the file are left floating. 


can, November {982 


segment 
assume 


Proc 
push 


ADF 


push 


nov 
BOY 
mov 


MOV 
Aoy 
int 
Or 

ynz 
ADY 
ADY 


int 


ROY 
HOY 
ROY 
int 
OF 

jnz 
ROY 
fO¥ 
int 


Odh ‘ASCII carriage return 
Gah ‘ASCII line feed 


far 

ds rsgye 29:0000 for final 
aK, ax ‘return to PO-DOS 

ay 


ax,data  jmake our data area 
ds, 3 raddressable 
Boa} 
‘GW create fil ACE, DA 
ah, 14h 


dx ,ortsei cb 
2h 


al,al ‘create surcessful? 
closers < no, Jump 
ah,? fyes, print success message 


dx,arfset msgi 
Zih 


snow set the record length 
sto 1024 bytes and write 
srandom data into the 
stile {using default DTA) 

word pir fcb+i4,i024 

ah, iah 

dy, offset fcb 

zih 

al,al twas write successful? 

closers  jyna, jump 

ah,? ‘yes, print SUCCESS message 


dx offset af 
71h 


cr re 
m 
| ned 

| 
2 
13 
cr ek 
fo. sar 
im 





88 


Dr. Dobb’s Journal, February 1984 


mT) 0035 84 10 ROY ah, (0h 

a7 0037 BA OL2A R ROY Gx ,atiset fcb 

a8 GO3A CD 2! int 2th 

a9 OO3C GA CAO or al,al ;close operation successful? 
50 OO3E 74 23 iz closers “iG, jump 

6} 0040 B4 O9 Rov ah,§ ;YES,Orink Success message 

42 0042 BA 0041 R nov dx offset asgl 

b3 6045 Cb 2 int 2th 

b4 

43 ;noW Clear out the file contro! 
bd stlock except for the filespec, 
a ;as though the tile had never 
b8 ;bEEn Gpenec, and then request 
9 ranother clase operation. 

7G 

fi OG47 BF O144 F ROY di,attset febti? 

?2 OO4A BF OO19 iD CX, 20 

73 G04D 22 [0 gor ala’ 

74 OG4F FL clog 

ik M050 F3/ AB rep stosh pthis zeros out the fcb 

?£ 

i 0052 Hd {0 hoy ah, 10h ;how close tile again 

78 6054 BR O13A R hOV dy offset feb 

78 0057 CD 2 int 2th 

BC) OO59 Of CO ar al,al rcheck status (Continued on next page) 





GGM — FORTH™ has HELP* 
for Z80' using CP/M? 


("BnNSsc 


BDS C 


\ 


GGM—FORTH, a complete software system for \ The fastest CP/M-80 C 

real-time measurement and control, runs on any . compiler available today 

Z80 computer under CP/M using an extended & Version 1.5 contains some nifty improvements: 

fig-FORTH vocabulary. & The unscrambled, comprehensive new User’s Guide 
te comes complete with tutorials, hints, error message 

GGM— FORTH features: & explanations and an index. 


The CDB symbolic debugger is a valuable new tool, 
¢ Open multiple CP/M files, in any combin- > written in C and included in source form. Debug with 
ation of direct-access and sequential-access, & it, and /earn from it. 
fully compatible with all CP/M utilities % Hard disk users: You can finally organize your file di- 
: a, ly rectories sensibly. During compilation, take advantage 
Char. in/out uses CP/M console, lister, file, or N of the new path searching ability for all compiler/linker 
port iy system files. And at run-time, the enhanced file I/O 
Pa ; mechanism recognizes user numbers as part of sim- 
On-line HELP* provides instant access to defi- & ple filenames, so you can manipulate files located any- 
nitions in the run-time GGM—FORTH dictionary . where.on your system. 


\ 


HELP* file is easily extended to include user % BDS C’s powerful original features include dynamic 
definitions using HELP* utility ® overlays, full library and run-time package source 

& code (to allow customized run-time environments, 
& such as for execution in ROM), plenty of both utilitar- 


HELP* is available during full-screen editing 
: . ® ian and recreational sample programs, and speed. 










Complete system and manuals $150. & BDS C takes less time to compile and link programs 
Manuals only: : S20. b than any other C compiler around. And the execution 
Introductory System: speed of that compiled code is typically lightning fast, 
? | ees $35 \ as the Sieve of Eratosthenes benchmark illustrates. 

GGM SYSTEMS, INC. (617) 662-0550 Q | (See the January 1983 BYTE, pg. 303). 

135 Summer Ave., ~ Reading, MA 01867 & BD Software 8” SSSD format, $150 

P.O. Box 9 Free shipping on pre-paid orders 

Brighton, MA 02135 Call or write for availability on 


280 i is a trademark of Zilog, Inc. 
* CP/M is a trademark of Digital Research, Inc. 


(617) 782-0836 other disk formats 


Circle no.:-30 on reader service card. Circle no. 5 on reader service card. 
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16-Bit Toolbox (Listing continued, text begins on page 84) 
Listing Two 


Bi QOG5B 73 94 inz closer@ ybad status,jumo 


fheS spect directary 
Bo HO5D BA 0064 & whov dy,affset msg4 
6 O00 ER 94 96 90 claser? 
qa] 
38 O63 closers: ;CORE Here if unexpected 
aq tfailure af disk operation 
30 O04) BR OLLL R mOoy du, offset nego 
1 
oe N64 closer?: rorint #essage ang exit 
93 G45 B4 09 ROY ah 3 


94 00a8 CD 2 int zih 


94 HOSA CR ret tfar return to Po-DOS 


G4 Hogg 4g { db 64 dup 
c 


ret} 


iQ bO4) starch ends 

ig 

119 

iil DODU data segment para public ‘DATA’ 

112 

113 )000 0D OA msg! qb cry li 

114 0002 46 £9 4€ 45 20 3! db File QUACK. DAT created’ 
115 59 41 43 48 2b 44 

i1é 41 54 20 43 72 45 

ii? hi 74 45 44 

118 M18 OD OA 24 ab cr,lf, $ 

1i¢ 

i2d COLE OD OA asg? db Cres 

{2i QO1D 31 30 32 34 20 &2 db ‘1624 bytes written into QUACK, DAT 
ia 79 74 65 73 20 77 

is 72 49 74 74 45 4E 

ie4 22 69 SE 74 OF 20 

25 S155 41 43 48 2€ 

12s 4441 5 


s-4 


GCOZE op 


— 
Lo 


24 db cr lf, $' 


Dat a] 


9041 90 OA msg db cr, lf 
0043 44 69 6C 45 270 §1 db ‘File QUACK. DAT closed oraperly’ 
oe 41 43 4B 26 44 

2 


4{ 5 43 Gf OF 


~~, 
— sf 


| ee cd —> ea ne 
Gd led ed Pa PR BS 
43 


th) -— 4 


OO i sesisesinstnnss 


\O 
o) 
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133 73 65 64 20 70 72 

134 &F 70 63 72 40 79 

135 D061 OD OA 24 ab ce 

13 

13? G064 OD OA 0A mog4 cb Cryit if 

138 0067 33 65 63 &F SE 44 db “Second close operation requested 
139 20 63 6 6F 73 45 

146 29 & 70 465 72 &l 

141 74 69 SF GE 20 7? 

142 ev ?L 75 45 73 74 

143 45 64 20 

144 0089 OF 66 20 66 69 4C db ‘on file QUACK, DAT’ 

145 65 20 31 55 41 43 

{4 4b 7E 44 4) 54 

14? 0099 OD GA db 

145 098 49 46 72 76 45 43 db ‘Inspect length af file QUACK DAT ° 
i49 74 20 40 65 46 47 

isd 74 69 26 SF 66 20 

idl 46 69 4C 65 26 St 

152 sa 41 42 48 26 44 

Lit 41 54 20 

4 GOEL éF bE 20 64 49 72 db on sirectory listing’ 

133 63 63 74 4F 72 79 

156 20 6C 69 73 74 89 

137 bE £7 

138 ODO 6D OA ob (Continued on next page) 





MOTOROLA SYNTAX 






OBJECT LIBRARIAN 
CROSS REFERENCE 











OBJECT CODE OPTIMIZED 
FOR CP/M-80, CP/M-68K 
OR IBM-PC 






PORTABLE C SOURCE 











Quelo 





Seattle, WA 98107 


CP/M is a trademark of Digital Research 
IBM-PC is a trademark of IBM 
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68000 


ASSEMBLER 


MACROS 
LINKER CONDITIONALS 








STRUCTURED PROGRAMMING FEATURES 





$300 


| $750 


(206) 784-8018 
843 NW 54th mornings 
Dick Curtiss 


















Introducing the KEY DP220 
from Key Micro Systems 


A complete 4-user (expandable to 
8-user) system with dual processor, 
dual half-height 8” drives and 20 
Mbytes. With it you can enjoy the best 
of an S-100 computer and run any 
mix of 8 and 16 bit programs 
simultaneously. Our use of the 
highest quality peripherals 
combined with the power 

of CompuPro boards delivers the 

_ reliability you need — at the right price. 
' For established systems, peri- 
: pheral support, or custom con- 
Sean figurations, we deliver the power 
eo ME you want at a powerfully 
affordable price. 

Key Micro Systems, Inc. is an 
a >. authorized CompuPro 

oa eer ws / Systems Center 







































Terminals optional. MICRO SYSTEMS INC. 


1606 Nooseneck Hill Rd., PO Box 715, Coventry, Ri 02816 - 401/828-7270 
822 Boylston St., Suite 201, Chestnut Hili, MA 02167 - 617/738-7305 
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onan pmeeeeneeeemeneennemmnanemen een ee 


fh /F switch to 


K wit 


HKDS 


Pun 


‘thes 


, text begins on page 84) 


db 


G 
q 


fi 


an 
- 
b 


ae 
oS 


ha 


0 77 8 


4 
oy 


f 


ry 
rat 
oe 


20 2F 46 


a 


n AB 


E20 43 46 45 


rf 


44 


5 6 
74 68 


+ 


: 


it Toolbox (Listing continued 


qon2 


Listing Two 


16 
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W}~ a> ie a 
m ify = 
“A CO ” a (4 
= | 
ta ©) *o0 1.20 oe 
ti Pene  VS asi ae 
mys Lu penn, © ne —, > 
= + 
"em 
fet oe ra CO Lu a _ ~ 0 i bd 
ie | ‘| —_—_ } 
it st os Ww = OD ~ > 
ame iq) 
ai iy orm rt ‘ 2 ® CC os = 
1 oqnet okest teens — 
+t +3 “3 <—T om (73 a ‘> Os oo < 
4 1 om —-" =n 
yeti | beet mead a wt © CO Cc). rab) — we © 
met ee | | | cs @ pial O _— 
i 43 LILI! no == ihe 
a ci LL] 20H SH ae 
we? fans Crh ates _— Cp) y= Ean p aa 
uf | is: LIJ Bylo oGw lo © 
ont et aco | 
5 = i BUDS OS m8 5 
teat iow al el a © ie eH 
us pe <a pWSececmMcu O 
ri “cn uk es ee see 8 Ss OW 
wren chi Const oe 
~ +t ~ Monee! 
i 4 oe | +5 cael 
ct ~ thi ~ 
= — ra. ” cee Fes Tose 
ae ps es tae 3 = a 
a | Paete} eee | cli net x, “Tr ure 
he ad ~~ we Fo | ror 
heer tis | AS. Lcs Es ina oveset 
it Ah us eo as C4 i 
ist 
it | ps | 
oe ian | oe vee | wilted. ~alied Po ieee | odie ‘fleas fh te | fae |r 
“ea igs SS “he be | gs se Fg 2 “kK wha ia 
cre hee meal 
ur oe ri 
ber) re “Kt 
Tas ee a oe Fa uo: 1 ee ae ha re saeanu" ‘eae. eeeeuai e& ~’ saeeees aneces 
“OM TF oe es Kod oe eT SGeAde Cl oere 
i rs 4 «ee Saat AR ee a Ea oo st aie 
en cee me a io TE pon ORE OR ne ea ve = ou 
et haw ta ID ID CD ee BS | Ea! re et “ih 
| ae Me I ed fr. WP Ca wi wa sy <= woe 
in. a Ca ce wa wry Wa ws Cok oo Se Oe — 
oh i OP t~-4 no i i el | “SE be 
“Ww SS - C1 rs om wos oO ti oo or Co ee Re sae bt 
| OE es MT aes TS eS oe coe pe 0 ot is C4 wt a : 
Ceo fd ca ws tN fa fos ete res OM Cane ne Ra 
Teh free en id eR Coie foot Re et a ae ne amen ae: est ee | 
han a Lat wt Pe {~-. er tc Pe ve 
a. ms mie te heed ro Qe: ee a a ia 
Laat nt ont wet wet ent _— — at 
— — cs <> = cor oe <S ein 
eck i A Pe CC) Cre oS we Oe ree oe oO Or. CO) re ce eet et OO. Ot Cr 
wf ME OO ee OM Ge OF om oo Ot oo OS co co tet fre ce or 
ee een eee eee ee eee en Ne es eo I foes tee ee eed cid ee ee es eed 


Dr. Dobb’s Journal, February 1984 


Circle no. 24 on reader service card. 


92 


MOTOROLA 68000 
STRUCTURED MACRO 
CROSS ASSEMBLER 
for CP/M-80* (8" SSSD) 
EXORmacst Compatible 


$200 


Manual 
$20 


Linker 7 Source 
included Available 


@ farbware 
1329 Gregory 
Wilmette, Ill. 60091 


“Trademark of Digital Research 
+ Trademark of Motorola Inc 
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I a PROMPT DELIVERY!!! 


SAME DAY SHIPPING (USUALLY) 


DYNAMIC RAM 
256K 150 ns_ $85.00 
64K 200 ns 5.97 
64K 150 ns 6.09 
64K 120 ns 6.97 
16K 200 ns 1.56 
EPROM 

27128 300 ns_ $19.20 
2764 250 ns 6.30 
2732 450 ns 4.25 
2716 450 ns 3.60 
2532 450 ns 

STATIC RAM 
6264P-15 150 ns 
6264LP-15 150 ns 
6116P-3 150 ns 


MasterCard/VISA or UPS CASH COD 
Factory New, Prime Parts Poo 
MICROPROCESSORS UNLIMITED 


Bere at Feona Wwe. (618) 267-4061 


Prices subject to change. Please expect higher prices on some parts due to world wide 
shortages. Call for volume prices. Subject to available quantities. Shipping & Insurance 
extra Gash discount prices shown. Federal Express Standard Air « $5.99! Orders received 
by 6 PM CST can be delivered to you by the next morning. We try harder 


Prices 12/14/83 
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Get the power of your Z80, and the elegance 
of direct access to CP/M functions 
from your high level programs with 


SYNLIB utility library 
SYNLIB consists of MICROSOFT compatible object 


code that may be called from any high level language 
that uses MICROSOFT parameter passing conventions 


SYNLIB gives you extremely powerful array and buffer 


manipulation using the Z80 LDIR instruction; program 
access to the CP/M CCP console command line; high 


speed disk block I/O; a high quality random number 


generator; hex to ASCI/! conversion optimized by special 
Z80 instructions; program chaining; and more. 


And, because our programmer abhors a vacuum, each 8” 
floppy comes packed with some of the most valuable 
public domain software, including available source, ab- 
solutely free. You get SWEEP, a menued disk utility that 
makes a computer phobe a systems programmer, 


UNSPOOL, so you can print and use your computer 


without buying an expensive buffer; /, to get multiple 
commands on a line; MODEM7, so that you too can join 
the free software movement; and many others. 

SYNLIB $50.00 8” SSSD CP/M format 

SOURCE: $100.00 
Licensing for commercial use available. 
SYNTAX CONSTRUCTS, Inc. 
14522 Hiram Clarke, Houston, Texas 77045 
(713) 434-2098 


CP/M is a registered trademark of Digital Research, Inc. 
Microsoft is a registered trademark of Microsoft Corp. 
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MEMORY FREEDOM FOR $99.50 
LOVLY-3 


The Overlay Linker from easy 


LOVLY-3 is a powerful development tool for the 
implementation of large Fortran programs that exceed the 
memory capacity of a microcomputer. 


LOVLY-3 is a linker with program segmentation and overlay 
capabilities. It accepts object files generated by MicroSoft's 
F80 compiler and M80 assembler, and produces executable 
programs which run under Digital Research’s CP/M 
operating systems. 


@ No modification of the source program being 
segmented; implicit loading of segments. 

®@ No limit on total program size; segment size up to 64k. 

® Multiple entry segments; up to 200 modules; 8 level deep 
overlay structure. 

® Complete user documentation with example. 


LOVLY-3 runs on Zilog Z80 and Intel 8080/ 8085 based 
micros with 56K memory and CP/M 2.x. 


Disk formats include: 5” NorthStar Advantage and Apple Il. 
Other disks available soon. 


Terms: Check or COD. 


easy 
Engineering Application Systems 
P.O. Box 10998 #529 
Austin, TX 78766-1998 
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HEATH. ..OSBORNE...KAYPRO. ..ANY CP/M*-80 


Tired of 16-bit Snobbery? 


C/NIXKEBO” 


Brings 
UNIX* Power to CP/M*-80 


Features Prices 


CINIX"™-80 65S 
Manual Only 


Hierarchical Directories 
UNIX*-like Shell 

I/O Redirection & Pipes 
On-Line Documentation Specify Disk Format 
GREP, CAT, LS, CHDIR, etc. Requires 48K CP/M-80 


C/Craft™, Attn: T. Taft 
22 Downing Road, Lexington, MA 02173 
(617) 862-8177 


Pie IX is a trademark of Bell Laboratories 
CP/M is a trademark of Digital Research 
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JVS-FORTH $10 
* SUPPORTS BYTE, INTEGER, AND REAL DATA 
* COMPLETE ACCESS TO CP/M 
® REQUIRES ASSEMBLER/LINKER BELOW 


BASIC COMPILER $20 


@ SUPPX S 9ER. REAL. AND 
EMENT TYPES 
ATES 8080 ASSEMBLER CODE 
ME LIBRARY SOURCE AVAILAB 
ONLY SS(REF WITH SO 
JIRES ASSEMBLER/LINKER BELOW 


ASSEMBLER/LINKER § $1 O 


SYMBOLIC 8080 RELOCATABLE ASSEMBLER 
NK EDI YR (LIBRARY SEARCH CAPABILITIES 
LIBRARIAN FOR LINK EDITOR LIBRARIES 


FREE BROCHURE AVAILABLE 


qponvecevstnepeueoniniusaiivencsastniaiaietusisesstsibeeds cisgessaceuaedaneeabas ° 
= REQUIRES CP/M-80 V2 2 ANC 2 


3740 SSSD OR APPLE 5's" 16 


WHEN ORDERING ADD S10 FC 
SHIPPING. HANDLING. AND MEDIA COSTS 
MASS. SHIPMENTS ADD 5°o SALES TAX 
MAKE CHECK OR MONEY ORDER PAYABLE TC 


JV SOFTWARE 
P.O.BOX 684-NEWTON, MA 02162 
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Now move files and programs between your CP/M-80 system 
and your Intel Series | or Il MDS! The ICX package provides 
complete bidirectional file conversion capability, and even 
allows execution of ISIS-II programs under CP/M using the 
ISE emulator. The ICX Package is composed of the following 
two programs: 







ICX A Deluxe bidirectional file conversion utility which 
works with your CP/M system and an 8” floppy drive to provide 
complete manipulation of an ISIS-Il diskette. Takes directories. 
deletes files, and even initializes a blank disk with the ISIS file 
structure. Complete C source included. $89 







ISE An IS!IS-II Emulator which allows ISIS programs to run 
on any CP/M-80 system. Support for all ISIS-Il system and 
monitor calls makes your CP/M micro look like an MDS! 

Supports banked memory. Complete MAC source included $89 


Complete ICX Package (ICX & ISE) $175 







Fae sta on 9 pears} fi heeft 


nex Westen Wares 


Box © 
Raat CO 81423 
(303) 327-4898 
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BRIDGE GRAPHICS 


PLOTPAK is a complete plotting library that runs under 


FORTRAN-80 and performs a variety of functions: 
windowing, linear print arrays, automatic polygon 
drawing, annotations, plotting symbol/line selec- 
tion, labeling, coordinate conversions. 


PLOTPAK can drive a screen and plotter 
simultaneously while maintaining a win- 
dow which allows you to communicate 
back to your FORTRAN program. PLOT- 
PAK includes your choice of the following 


drivers: SCREENS 

* MicroAngelo MA 512, 520 

¢ ADM + Retrographics 

e TEK 4010 Compatible Terminals 

e Otrona ATTACHE Portable Computer 

PLOTTERS 

e H. P. Plotters 7225B & 7470 

¢ Houston Instruments DMP-4 
PLOTPAK (.REL file) + two drivers... $190 
PLOTAK (source code) + two drivers....... $240 


7 \ BRIDGE 


Computer Company 
DIVISION OF SEA DATA CORPORATION 

ONE BRIDGE ST.. NEWTON. MA 02158 
PHONE (617) 244-8190 





























80 CHARACTER VIDEO BOARD 
¢ WORDSTAR/dBASE II OPTION 


e TYPE AHEAD KEYBOARD BUFFER 


e 25 LINE NON-SCROLL OPTION 

e Z80 CPU and 8275 CRTC S-100 

¢ CHARACTER GRAPHICS 

e ADAPTABLE SOFTWARE 

¢ ORDER ASSEMBLED & TESTED OR 
PRE-SOLDERED (ADD YOUR IC’s) 


VDB — A2 bare board from $49.50 


Simp liway PRODUCTS CO. 
_ (312-359-7337) 


P.O. BOX 601, Hoffman Estates, IL 60195 
add $3.00 S&H, 3% for Visa or Mastercard 
Illinois Res. Add 6% Sales Tax 
WORDSTAR is a trademark of MicroPro INTERN’'L CORP. 
dBASE is a trademark of ASHTON-TATE CORP. 
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C/UNIX PROGRAMMER'S NOTEBOOK 


by Anthony Skjellum 


In the first installment of this column, 
I proposed a standard for the layout of C 
code (see DDJ No. 84, October 1983). 
Significant reader response was received 
concerning this subject, the vast majority 
of which was in favor of the concept of a 
C layout standard. In this column, I will 
present reader comments concerning the 
layout standard and discuss some modifi- 
cations and additions to the proposed 
standard based on reader suggestions. 

Some comments were also received 
concerning my discussion of runtime li- 
brary and linkage format incompatibili- 
ties. Discussion of these points will be 
left for a future column. 


Questions of White Space 


Several readers took exception to a 
particular point in the proposed layout 
standard, 4F, which states, ““No white 
space character is placed between a key- 
word (e.g., if) and its parenthesized argu- 
ment.’ David D. Clark of State College, 
Pennsylvania, writes: 


“In general, I like your coding stan- 
dard suggestions. My only strong objec- 
tion is to your idea to leave out spaces 
between reserved words [and their argu- 
ments]. It makes them look like function 
invocations.” 


Tim Smith of Evanston, Illinois, 
notes: 

‘<I think that a single space be- 
tween a function name and the initial 
opening parenthesis, or after ‘ifs’ and 
‘elses,’ looks better... .” 


Guy Scharf of Mountain View, Cali- 
fornia, writes: 

‘“‘4f. I have a strong preference to 
always put a space between a reserved 
word (e.g., if, while) and its parenthesized 
argument. This adds legibility for me.”’ 


Finally, Charlie Brady of New South 
Wales, Australia, writes: 

‘*The only real beef I have with you 
is the formatting of keywords and their 
parenthetical expressions. I can see no 
reason to depart from Kernighan and 
Ritchie on this point, and a number of 
reasons for maintaining their convention. 
Firstly, a flow control construct is seman- 
tically distinct from a function call, and 
a formatting difference is a reasonable 
way of distinguishing them. Secondly, the 
formatting difference simplifies the use of 
a text editor for such tasks as construct- 
ing structure charts. Third, your recom- 
mendation departs from at least three 


extant recommended standards, namely 
Kernighan and Ritchie, Thomas Plum (C 
Standards and Guidelines, Plum-Hall, 
1981) and Tim Lang (‘Formatting C,’ 
AUUGN, Vol. 4, No. 1, Jan. 1982. En- 
closed ).’’ (I want to thank Mr. Brady for 
including a copy of the Lang article with 
his letter. The C standard proposed there 
is very compatible with the one I have 
proposed.) 


After considering the above remarks, 
I have come to the conclusion that the 
space really does serve a useful purpose. 








Therefore, I suggest that point 4f should 
be changed to read: “A single white char- 
acter is (optionally) placed between a 
keyword (e.g., if) and its parenthesized 
argument.’ (Making the white space 
character optional is another point for 
debate.) I think it should be optional but 
recommended. I don’t think that adding 
a space for function call invocations 
would be beneficial, as suggested by Mr. 
Smith. 

Another question concerning white 
space insertion comes in connection with 
argument lists. The original standard does 


if( (a == 1) && (b == 2) && (c ==3) && ( (d == 4) I] (d==5) ) ) 


f 


/* operations performed if conditional true */ 


/* we make multi-line expression look like a block */ 


/* operations performed if conditional true */ 


Figure 11. 


(Under section 4) 


b. Binary operators (e.g., +, 
operators (e.g., =, *=, 





-, /, but not —> and .) and assignment 
and &=) are delimited by white space. 


g. Parentheses should be adjacent to the argument(s) which they enclose. 


h. A comma is bound to the argument which precedes and should be fol- 
lowed by a single space. 


i. Operators such as —> and 


(used in pointer references) directly 


bind to their arguments with no intervening spaces. 


Table 1. 
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not indicate if spaces should be included. 
It is my opinion that a comma should be 
directly adjacent to the argument that it 
follows, and that a single white space 
should follow each comma to add legibili- 
ty. | am also convinced that parentheses 
should be adjacent to the argument(s) 
they enclose. Thus (in agreement with 
Tim Lang’s article mentioned above), I 
would write: 
x = atan(sin(y) ); 
and not 
x = atan(sin(y ) ); 

Yet another point not previously 
mentioned is that binary operators should 
be delimited by white space. Thus, the 
following statement lacks sufficient white 
space: 

v = sin(1n(1.0+x) ); 
while this expression is properly formed: 
v =sin(1n(1.0 + x)); 

Finally, section 4 needs to be updated 
to include a style specification for pointer 
references. I think that operators “‘.” and 
“>” should not be delimited by spaces 
from the objects which they act on. This 
point and the three above are formalized 
in Table 1 (page 94) as additions to sec- 
tion 4. 

The Lang article points out a circum- 
stance under which point 4g need not be 
followed. This occurs when very compli- 
cated conditional expressions of the form 
‘““keyword (expr)” are split over several 
lines. In Figure 1 (page 94), for example, 
instead of using a crowded expression 
(Figure la), a more readable form is se- 
lected (Figure 1b). Note that in Figure 
1b the parentheses are placed on lines by 
themselves, since they bracket a multiline 
expression, much like braces enclose the 
statements of a block. 


Another point of minor objection 
was the tabulation method specified by 
the standard (point la). Steve Newberry 
of Los Altos, California, states: 


‘““Upon one point I do feel compelled 
to argue with you, and that is the tab 
convention: The depth of the tab stop on 
a given page is of far less significance to 
the readability of that page than is the 
consistency of the depth. I really don’t 
want to use different size tabs on the 
same page.”’ 


Tim Smith writes: 


“IT personally follow most all of his 
suggestions on how to actually format 
the code on the line and page, with only 
two exceptions. I always use 4-space tab 
Stops... ... 


I agree that having a single tab size is 
the preferable way to write C code. Stan- 
dard tabs give more openness to the code, 
and make various parts of a program easier 
to pick out. My rationale for large hori- 
zontal tabbing is the same as for vertical 
tabbing. I want the program’s significant 


portions to stand out. However, I propose 
adding point 1b to the standard: ‘‘4-space 
tabs may be used in lieu of standard tabs 
in cases where a subprogram includes 
highly nested segments.’’ I would also in- 
clude point Ic: ‘Only one of the two 
tabbing conventions should be employed 
in any given program module.” 

Some currently available screen edi- 
tors provide a feature called horizontal 
scrolling. With horizontal scrolling, the 
user views a window of the file in both 
the vertical and horizontal directions. 
Thus, files with lines longer than the dis- 
play device may be handled intelligently. 
Under such circumstances, there is no real 
disadvantage to using standard tabs to 
any desired nesting depth, which is per- 
mitted under point la of the proposed 
standard. 


Other Corrections 


Charlie Brady noted an unnecessary 
point in section 3e which stated: ‘‘When 
a null block is used (e.g., ‘{}’ ), it may 
appear on the same line as other state- 
ments (e.g., do {+ while(expr);).” He 
writes: 


“Another minor point of disagree- 
ment concerns the use of the null block 
(4+). This is never necessary, and I be- 





No more lost edit changes! = 


lieve that the null statement (; ) is clearer, 
It should be emphasized that the null 
statement deserves a line of its own. Your 
example: 
do ¢} while(expr); 
is more simply written 
while (expr) 

In accordance with Mr. Brady’s re- 
mark, I propose replacing point 3e with 
the following: ‘‘The null block ( { }) can 
always be avoided. Instead of a null block, 
use the null statement.’ I also would add 
point 3f ii: “‘The null statement is always 
on a line by itself.” 


Documentation Standards 


In addition to a code layout standard, 
James Halstead of Joliet, Illinois, has pro- 
posed a basic documentation standard. 
He writes: 


**...1 strongly suggest that the origi- 
nal standards one through nine be renum- 
bered two through ten so that the first 
and foremost standard may be inserted.” 


The documentation standard sug- 
gested by Mr. Halstead is presented in 
Table 2 (page 96) and I think it should 
be included in my proposed standard. 
However, I have decided to number the 
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specter ener cn st A 


0. Identification Description (1.D.) information must appear at the beginning 
of each C language source file. 


a. The recommended format i is: 


i. 
ii. 


xii. 


"i. 


XV. 
* 


xiv. 


Xvi. 


Begin comment (/*). 
Space. 


i. Title (identification name normally = filename). 


Sub-title (i.e., what program system does this file belong to). 
Space. : 
Classification see below). 


il. Year. 
i. Owner. 


Status (see below). 

Current Version number and brief higons. 
Date. 

Functional /Structural Description i in brief. 
Portability synopsis. 


‘Space. 


End Comment (*/). 
Space. 


b. The program classification (vi.) is one of the following: 


i, 
il, 
ei 
iv. 
Vv. 


vi. 


Public-domain. 

Copyright. 

Copyright: released for non-commercial purposes. 
Unclassified. _ : , 
Secret. / | : 

No classification. 


c. The program status (ix.) is one of the following: 


1 
il. 
ou. 

iv. 


Outline. 


Draft. 
Test (alpha, beta, etc.). 
Release. 


Table 2. 


10. Each function should contain the following minimum documentation: 
a. A general explanation of the function performed. 


b. Its name, and a description of its arguments including their types, and 
legal values. 


. Adescription of the functional return value, if any. 

: A list of non -standard functions used by the function. 

. A list of external variables used and/or modified by the function. 
. Adescription of the error handling characteristics of the debe wets 
A valid calling sequence example, aft practical. 
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Table 3. 





documentation standard as Section O in 
order to preserve the numbering of the 
current sections. (The slight additions I 
have made include an asterisk to indicate 
the addition.) 

In addition to Section 0, I think a 
basic documentation standard is in order 
for functions as well. Such a standard is 
presented in Table 3 (page 96). I have 
placed this under Section 10, since I 
think of function documentation as a 
separate task from module documentation 
as described in Section 0. 


Other Proposals 


Several other readers made sugges- 
tions for the standard. I think that Tim 
Smith proposes several which merit dis- 
cussion. They are presented here with the 
point numbers they receive as part of the 
standard: 


5c. Don’t nest comments, even if your 
preprocessor/compiler allows it. 


6f. If there are many declarations, wheth- 
er one line or many, alphabetize them. 


9g. Restrict variable and function names 
to seven well-chosen characters, even 
if your compiler allows more. 


Steve Newberry writes the following 
about standards: 


“I applaud your interest in establish- 
ing a standard format convention for C 
programs. However I feel that your effort 
would have more impact if tied to support 
of Tom Plum’s book, C Programming 
Standards and Guidelines, Version U (Unix 
and offspring), Edition 3: Jan. 82. Pre- 
sented in this manner, your proposed for- 
matting standard would be seen as a con- 
sistent extension of a more general set of 
standards already in wide circulation.” 


Other Points of View 


Although most readers were favora- 
ble to the idea of a C format standard, 
Douglas M. Potter of Seattle, Washington, 
writes: : 

““Il’m afraid I don’t see much advan- 
tage of your proposed standard over theirs 
[Kernighan and Ritchie]. In both cases, 
the size of the indent is too large. I always 
run out of room on the right side with a 
tab-sized indent. I also find that mOpOdy 
uses enough white space.” 


John F. Draffen of Texas City, Texas, 
wrote me a detailed letter on why he 
didn’t like the idea. He writes: 


“IT am writing to express my objec- 
tions ...In the first place, I do not think 
a standard of this type is either necessary 
or desireable. The layout has nothing to 
do with portability which to my mind is 
the only excuse for a standard. It seems 
to me that it is hard enough to get people 
to agree on necessary standards. 

“‘In the second place, I do not agree 
with many of your suggestions on style. 
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One of the nice things about C that it 
shares with Fortran is its relative concise- 
ness. I do not like to see code strung out 
unnecessarily. C does not interject un- 
necessary constructions, and I think that 
introducing unnecessary white space, ex- 
cessive indentation, and meaningless com- 
ments is a kind of gingerbread that we 
can do without.’ Mr. Draffen’s style of 
philosophy is listed in Table 4 (page 97). 
I don’t really agree with Mr. Draffen 
on several counts. First and foremost is 
that portability is not the sole subject of 
importance in programming. The ability 
to maintain, understand, correct, and 
enhance code is of great importance. To 
understand someone else’s code (or your 
own code at a later date) requires some 
degree of formatting. Comments which 
seem less than essential to the program- 
mer must sometimes be included for the 
sake of others. This is immensely impor- 
tant. It is often difficult for programmers 
to know how to comment their code, since 
they usually cannot know the level of so- 
phistication of later readers. Thus, it is 
often better to include a few extra com- 
ments, than to comment code sparsely. 


I suggested in my previous column 
that users should maintain their own code 
in the form that they prefer. However, 
code distributed to others could (and 
should) meet some minimum standard of 
neatness (1.e., formatting) and presenta- 
tion. Some of this can be provided by a 
beautifier but most must be done by the 
programmer. 

As one final note on C layout, I’m 
including an insightful paragraph which 
Tim Smith included in his letter. It sug- 
gests why so much C code is so poorly 
formatted and commented: 


“I don’t think, however, that you 
will ever get Unix wizards to follow these 
recommendations. I should have noted 
that I use Skjellum-like conventions 
when I’m writing micro-based applica- 
tions. When I’m maintaining Unix sources 
I stick with the standard Unix conven- 
tions, which are pretty much Kernighan 
and Ritchie standard. Unix whizzes 
think that aligning curly braces is irrele- 
vant, since “vi,” the editor which 90% 
of them use, will always let you find the 
top or bottom match for any brace auto- 
matically. Also, and probably more im- 
portant, Unix system guys always debug 
by staring at their CRTs, never from print- 
outs (that’s for COBOL programmers), 
and the goal is to reduce the number of 
lines of a function, so that as much of it 
as possible will fit on a screen. Seeing a 
whole line taken up by just an opening 
brace must drive them whacko, and some 
of them will even close blocks on the end 
of a line of code (yecch!).” 


In this column, I have presented 
additions and corrections to the pro- 
posed layout standard, based on reader 


response. I have also presented the oppos- 
ing point of view. Most of the letters re- 
ceived were positive, so it was difficult to 
include more dissenting remarks. I want 
to thank those who sent in their com- 


ments about the standard. BB 


Reader Ballot 
Vote for your favorite feature/article. 
Circle Reader Service No. 200. 


Punctuation should be used sparingly. The insertion of unnecessary white 


space should be avoided. 


Block structures should be used, 


indentation should be avoided. 


indicated by indentation. Excessive 


Comments and program code should be separated. Comments. on the 
same line as code should be displaced far enough to the right that a ey 


do not obscure the code. 


Comments should be meaningful. Comments that do no more ‘than - 
peat what has already been said by the code should be avoided. 


Table 4. 
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by Michael Wiesenberg 
















































Networking PCs 


PCterminal, from Santa Clara 
Systems, is an IBM-compatible per- 
sonal computer with built-in local 
area network. Use it as an intelligent 
terminal in an IBM PC network, PCnet, 
instead of IBM PCs, to increase user 
stations at one-third the cost. You get 
monitor, keyboard, 8088, serial and 
parallel interface, four expansion slots, 
64K RAM (expandable to 256), built- 
in networking, and connection for 
optional 5.25-inch floppy disk drive, 
for $1295. It runs either PC-DOS or 
Santa Clara Systems’ version of MS- 
DOS, SCS-DOS. You can connect up 
to 16 PCterminals to one IBM PC or 
XT in a Santa Clara Systems network. 
PCnet, built into the terminals, lets 
PCs link with thousands of others 
through special adapter boards and 
software. ““Remote execution” permits 
one terminal to run a command on 
another. Reader Service No. 101. 


8086 C and Pascal 


Whitesmiths has Release 2.2 of its 
C and Pascal compilers, adding 8086 
architecture and Unix-style libraries. 
Whitesmiths now supports over 30 
operating systems on five architec- 
tures: PDP-11 family, 8080 and Z80, 
MC68000, VAX family, and 8086. 
The last includes 8088, with optional 
8087 math coprocessor support plus 
80186 and 80286 instruction sets. On 
IBM PC, programs run under CP/M-86, 
DOS 1.x, and DOS 2.0. C native com- 
piler is $550, Pascal native $1100, C 
cross compiler $1100, Pascal cross 
$1400. Reader Service No. 103. 








The Digital Doctor 


Not to be confused with the resi- 
dent intern, the digital doctor makes 
house calls. Data Encore, a subsidiary 
of Verbatim, offers the Datalife Disk 
Drive Analyzer, a diagnostic software 
tool to check disk drive performance, 
testing head alignment, disk clamping, 
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write/read accuracy, and disk speed. 
$39.95 for IBM PC, XT, and Apple. 
The latter includes enhanced graphics. 
When you return the warranty card, 
Data Encore will send you a free Data- 
life Twin Pack of minidisks or head 
cleaning kit. Reader Service No. 105. 


Box It 


You can make your IBM PC por- 
table, or at least somewhat transport- 
able, by putting it in a Firebilt case, 
for $181, and put the monitor and a 
printer in another case for $191. These 
are foam-padded luggage style cases 
made of high-impact plastic. Other 
cases made of plastic, aluminum, or 








fiberglass are available for scores of 
other computers, monitors, and 
printers, ranging in price from $65 to 
$315. Reader Service No. 107. 


Computer Becomes Typewriter 


Last time I described a product 
that turns electronic typewriters into 
printers. This time, to be fair, I men- 
tion a product that lets your printer 
become a typewriter, controlled by 
the keyboard of your computer. Hall 
Associates think that you do not want 
to be so inefficient as to call up your 
word processor just to type out one 
mailing label or a short note, and so 
they offer TYPWTR that lets your 


Inexpensive Plotter 


The Model CR -1810 Comscriber I, 
from Comrex International, is a light- 
weight, single-pen plotter that takes 
paper 8.5 inches wide and up to 10 


feet long, and pauses to change pens. 
The price is $695. Reader Service 
No. 119. 
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BOWE: 


Check out InfoWorld's Rave 
review of POWER Nov. 8/82) 


95 CP/M 
UTILITIES IN 
ONE PACKAGE 


... The super program that puts you in control of CP/M 
(or MS-DOS) and your winchester. 


POWER automatically numbers disk files. Just pick file 
number to Copy, Erase, Reclaim, Type, etc. 

... Your computer feeds the file names automatically. 
Youdo NO typing! NO typing error ever! 

YOU DON’T NEED SYSTEM DISK IN ANY DRIVE. 

No more BDOS ERROR! 


YOU Test and Fix bad disks! Reclaim accidently erased 
files or programs! Single step thru memory up or down! 
Search, view, change memory or disk in a snap! See 
Status and File Size instantly! Verify check-sums for 
programs! Load or Save programs at any address. 


55 prompted user-friendly funstions for housekeeping 
and a 120 page easy-read user’s guide make POWER 
your most often used software. You'll use it every day! 


Now, POWER! also includes a special program that lets 
you lock sensitive files, so that only you can access 
then. Without the secret PASSWORD which you can 
create and change at will, no prying eyes will ever 
know your secret file even exists. 


SOME MAJOR POWER COMMANDS: 


REN CM WRITEGR DISK STAT 
TYPEA USR 2 DUMPA SPEED SETDIR 
SIZE ERA SEARCH WRITE RECLAIM 
XUSER TYPEX ? DUMPX DS 
SETRO CHECK COPY FILL READ 
GROUP _ TEST TYPEH EX DUMP 
SAVE SETWR EXIT DIR MOVE 
READGR LOG USER TYPE JP 
DUMPH LOAD SETSYS RUN 


44 MEGABYTE (FORMATTED) 
5 1/4” HARD DISK Including 
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POWERL $1995 





For this low price your winchester will be delivered completely assem- 
bled and tested, with drive controller, case, power supply, cabling, Z-80 
interface and the best disk controller software on the market. 


@ The unique and simple interfacing system does not 
tie Up existing ports. 

@Significantly faster than other winchester sub- 
systems which interface through the IEEE-488 port. 

@ CP/M drivers require minimum memory overhead 
(about 2K-other systems require as much as 6k) 

@ The MD-10 can read or write a 64K file in less than 
four (4) seconds. 

@ A network system will be available shortly which can 
support up to sixteen mixed types of computers from 
one MD-10 or larger disk subsystem. 

@ With POWER! Software files can be code word protec- 
ted. 

@ Other systems available: 22 and 44 megabytes 


MD-20 with 22MB formatted: $2895 
MD-44 with 44MB formatted: $3995 


@ Up to eight (8) winchester subsystems can be inter- 
faced to one computer. 

@ Software supports 32 different user areas per MD410. 

@ Backing up hard disk files is simple with the special 
software which is provided with all subsystems. 

@ With a single hard disk installation, the MD-10 sub- 
systems becomes units A and B with the standard 
drives being designed E and F if a second MD-10 is in- 
stalled later it becomes units C and D. 

@ MD-10 or larger systems will interface with IBM PC or 
any Z-80 computer (CCS, APPLE (CP/M), 
ZENITH/HEATH, NORTHSTAR, GODBOUT, XEROX 
820, Z-80/S100, ALSPA, or TRS-80 MOD II) using 
CP/M, OASIS,PCDOS 2.0, andGodbout Software sup- 
ports both CP/M and MP/M816. 

® Double density modifications are available allowing 
you to later increase the capability of an MD-10 to 
about 20 megabytes, MD-20 to 40, etc. 

@ Full One-Year Warranty 





HIGH PERFORMANCE STREAMING TAPE 


Unique! Simple! 


Compatible! 





@ Field-proven Archive Sidewinder tape unit. 
@ Interfaces with ANY SASI/SCSI compatible hard disk peripheral. 


@ Full CRC error-checking 
®@ Superb reliablity. 
@ Full One-Year Warranty. 


@ Fast (up to 20MB in less than 5 minutes, up to 40MB in less than 10 minutes). 


$1795.00 20MB 
$1995.00 45/60MB 


$29.95 3M DC300XL 
Streaming Tape Cartridges 





o.; ORDER OR FOR MORE INFORMATION: 
(801) 257-7033 or mail to MEGA-BYTE INC. RT. 3 Box Ks bide idiot Utah 84337 


TERMS: Cashiers Check, VISA, M/C or COD. 





aia Shipping charges added to all orders. 
Name ty. Price Total 
i 
COMPANY TITLE 
ee ayes pessimist ee oe eee 
ae) Roe |i: QNGWSESY kate tere ce ae sR AE ae 
TELE ) 
VISAAO M/CO COD UO Total Order 
Dat lf Utah Tax CP/M is a registered trademark of Digital Research. OASIS is a 
— ciety proprietary product of Phase One Systems Inc. Z-80 is a trademark 
Signature Total Enclosed of Zilog. MD-10 is a registered trademark of Media Distributing. 
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printer immediately track every key- 
stroke. (What’s wrong with using 
CP/M’s Control-P?) You can have 
lines of 250 characters and word wrap; 
you can set margins and tabs. You 
need CP/M 2.x, 48K, and a printer 
that backspaces and does carriage re- 
turns without line feed. $29.95 plus 
$1.50 p. and h. Reader Service No. 
1273. 


2068 and Adam Too 


Looks like Timex has another 
winner with its 2068 Personal Color 
Computer. The under-$200 computer 
seems to address itself to all the dif- 
ficulties users of the 1000 and 1500 
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For your inexpensive printers, 
you need inexpensive word processing 
software. Homeword, from Sierra On- 
Line, comes with software, book, and 
tutorial audio cassette. Features in- 
clude icons, or pictures of operations 
such as a file cabinet for filing, a page 
of print for editing, a printer for print- 
ing, and an unorganized page with an 
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had. The new machine has a “‘real”’ 
keyboard, not just sound but synthe- 
sizer capabilities, instant-load car- 
tridges, high-resolution color graphics, 
joysticks, etc. What it lacks is a lot of 
software, although I understand Timex 
is adapting Sinclair Spectrum software 
as fast as they can. In the meantime, 
Softsync fills the gap with several 
games, Cosmic Gorilla (“‘masses of 
mutant mohair relentlessly stealing 
everything they can get their hands 

”’), Gulpman (“‘The cursed wormoids 
are out to get control of Gulpland, 
chasing its inhabitants out of their 
apple orchards. Eat as many apples as 
you can to get bonus points and use 
your lasers to stun the wormoids’’), 
Cyberzone, a voice-actuated game, all 
on cassette and all $19.95. Voice 
Chess talks to you during play, recom- 
mending moves, if you wish, letting 


Spr lngs loving 


of tunctic 


you switch sides, and analyzing moves, 
$24.95. Softsync also has Zeus Moni- 
tor/Disassembler and Zeus Disassem- 
bler, $19.95 each, indispensible for 
machine language programmers. 

And if you need software for your 
Coleco Adam, Softsync has Personal 
Accountant, a double-posting book- 
keeping program for household and 
small business use, $34.94 for cassette; 
Model Diet, computerized meal plan- 
ning based on nutritional require- 
ments, $29.95; Dancing Feats, a one- 
man joystick band that lets even begin- 
ners play synthesized music instantly 
accompanied by synchronized color 
display, $29.95. 

Softsync also offers many of these 
programs for Atari, Commodore 64, 
and IBM PC. Reader Service No. 121. 
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Inexpensive Word Processor 


arrow pointing to an organized one for 
formatting. The specifications for this 
product seem similar to other word 
processors, but less usual features in- 
clude a HELP key and the division of 
the screen into three sections. The 
upper section is largest and holds the 
working text. The lower right section 
shows a replica of the page as it will 


Prev OSE charac jer? 


racte 


ard 


re wardé 


appear printed. The lower left lists 
available memory and disk space. The 
price is $49.95 for Apple II, II+, and 
IIe (soon available for Commodore 64 
and Atari). Also included is a 30-day 
money-back guarantee. Reader Ser- 
vice No. 117. 
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Computers Talk to Each Other 
and the World 


The MITE/86 data communica- 
tions program, from Mycroft Labs, 
turns computers into intelligent ter- 
minals to use with The Source, Com- 
puserve, and the like, and to transfer 
files between 8- and 16-bit com- 
puters. You get full control over all 
communications parameters (parity, 
baud rate, etc.), automatic logon, 
three binary file protocols (XMODEM, 
CLINK/CROSSTALK, and Hayes), 
and everything else you’d expect of a 
good communications package for 
CP/M, for $195. The system is precon- 
figured for Rainbow, PC, Victor, and 
other CP/M-86 systems and is also 
available for various CP/M1-80 systems. 
Reader Service No. 111. 


Low-Cost Printers 


Alphacom offers a 40-column dot 
matrix printer, the Alphacom 42, that 
interfaces with most computers, for 
$99.95, complete with interface cable, 
or $79.95 without cable. It has upper 
and lower case and recognizes standard 
ASCII control codes. Alphacom also 
offers an 80-column, 100 cps printer, 
the Alphacom 81, for $214.95, includ- 
ing cable. Reader Service No. 115. 





Advertise 
In the May Issue of 


Dr. Dobb's Journal 


Space Reservations Deadline: 
March 1, ‘84 


Material Deadline: 
March 8, ‘84 


Contact: 


Walter Andrzejewski 
Beatrice Blatteis 
Alice Hinton 


Dr. Dobb’ Journal 
P.O. Box E 
Menlo Park, CA 94026 
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Basic BASIC 


A good language needn’t cost hun- 
dreds of dollars. The Nevada BASIC 
interpreter for CP/M systems, by Ellis 
Computing, is $39.95 for the diskette 
and documentation. The language in- 
cludesIF ... THEN... ELSE, BCD 
math (no rounding errors), 8- or 12- 
digit precision, single and multiline 
user functions, full matrix operations, 
and a full-screen text editor which can 
be accessed by pressing the RETURN 
key when a runtime error occurs. 
Reader Service No. 109. 


Quiet, Fast Printer 


Blue Chip Electronics has a 40 
cps, 132-column, daisy wheel printer, 
called Model BCD-4015, with an 
optically controlled print head that 
automatically inserts paper and adjusts 
the left margin. The noise level is 57 
decibels, which, they claim, makes it 
one of the quietest daisywheel printers 
available. It’s bidirectional, logic seek- 
ing, and takes over 100 different print- 
wheels. In addition to proportional 
printing, boldfacing, and underlining, 
a tractor feed is standard. There is an 
optional cut sheet feeder. Centronics 
8-bit parallel interface is standard, and 
serial RS-232C, IBM PC, and IEEE- 
488 are optional. Warranty and after 
sale service are provided by General 
Electric Instrument and Communica- 
tions Service Department, so mainte- 
nance and repair are available at 26 
GE service locations in the US and 
Canada. The suggested retail price is 
$1,895.00. Reader Service No. 133. 


Fast Z80 Forth 


q4th for CP/M, from Quanta 
Corporation, is claimed to be the 
‘fastest Forth for Z80 in the known 
universe.” It’s a superset of Forth-79, 
is an interpreter and also compiles to 
Z80 machine code, and has a runtime 
debug trace with stack display $95 in- 
cludes one year update and newsletter 
subscription. Reader Service No. 125. 


BBJ 


Reader Ballot 
Vote for your favorite feature/article. 
Circle Reader Service No. 201. 





Usp 


IBM PERSONAL 
COMPUTER. 


THE PREMIER LANGUAGE 
OF ARTIFICIAL 
INTELLIGENCE FOR 

YOUR IBM PC. 


DATA TYPES 
Lists and Symbols 
Unlimited Precision Integers 
Floating Point Numbers 
Character Strings 
Multidimensional Arrays 
Files 

Machine Language Code 


HM MEMORY MANAGEMENT 
Full Memory Space Supported 
Dynamic Allocation 
Compacting Garbage Collector 


M@ FUNCTION TYPES 
EXPR/FEXPR/ MACRO 
Machine Language Primitives 
Over 190 Primitive Functions 


10 SUPPORT 
Multiple Display Windows 
Cursor Control 

All Function Keys Supported 
Read and Splice Macros 
Disk Files 


POWERFUL ERROR RECOVERY 
8087 SUPPORT 

COLOR GRAPHICS 

LISP LIBRARY 


Structured Programming Macros 
Editor and Formatter 

Package Support 

Debugging Functions 

.OBJ File Loader 


M@ RUNS UNDER PC-DOS 1.1 or 2.0 
Ss SO Se eres 


































IQLISP 











5%"’ Diskette 
and Manual. ———S~*SH1175.00 
Manual Only $ 30.00 


fi q Integral Quality 
P.O. Box 31970 

Seattle, Washington 98103-0070 
(206) 527-2918 


Washington State residents add sales tax. 
VISA and MASTERCARD accepted. 
Shipping included for prepaid orders. 
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COMPUTER RESOURCES 


of WAIMEA 
Menu Driven Programs running under SPELLBINDER 


will free your operators from entry 
errors. Completely menu driven Mailing List Management Programs 
with thoughtfully formatted screens to ease the entry of addresses and 
names. Integrity of the data file created is automatically verified. No 
more printing ‘bad’ mailing labels with misplaced data; AND each add- 
ress record can be individually classified to allow inclusion (or exclu- 
sion) when printing labels or form letters. 


(10 Programs) 


Break Through the 
64K Barrier! 


make your version of 


Spellbinder menu driven. No more fumbling through manuals for 
obscure or little-used commands. The complete instruction set can 
be displayed at any time without disturbing the text on the screen. 
These two programs put Spellbinder into the world class of word 

processors, allowing the user to easily use its truly outstanding fea- 


FORTH-32™ lets you use up to one megabyte 
of memory for programming. A Complete 
Development System! Fully Compatible 


Software and 8087 Floating Point Extensions. 
tures. 


(With two help files) ~ Call today toll-free or 

contact a participating 
automatically saves the text on the Sant Maser wae Computerland store. 
screen to a previously named file. Prevents the inadvertent but all so 
common save to a wrong name. Works with source code and program 
code as well as with text files. All instructions on disk. 


(3 Programs) 


303 Williams Ave. 


oe 800-558-8088 


Now available for the IBM PC, PC-XT, COMPAQ, COLUMBIA MPC, 
and other PC compatibles! 


Send Check, Money Order, Visa, Master Charge: 
COMPUTER RESOURCES OF WAIMEA 
P.O. Box 1206 
Kamuela, Hawaii 96743 
Phone: (808) 885-7905 


IBM, COMPAQ, MPC, and FORTH-32 are trademarks of IBM, COMPAQ, Columbia Data Products, and Quest Research, respectively. 
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e What's easier than 
Q 









spending money? 

@ Keeping track of it with... 
Q | 

Checks Balances 


At last! A full screen editing checking and finance program so informative and 
easy to use you'll wonder how you lived without it! Especially at $4995 





Sixteeen user-definable categories. Category totals instantly updated with each 
new entry or change. 


Includes 
categories for 
bills, cash ex- 
penditures, 
deposits and 
service charges. 


Screen always 
shows four entries. 
Use your cursor to 
add or change any 
entry anytime. 
Scroll forward and 
back through your 
register or instantly 


go to any entry. Checks and 


Balances aligns 
decimals and 


ee . left justifies text. 


For complete rec- 
ords, cash expendi- 
tures are included 
in category totals 
but not bank bal- 
ance. 


Entries which 
have cleared 
through your 
bank. 





Bank statement balance reflects only 
All commands in plain True checking balance instantly updates items checked off as having cleared your 
English. with each entry. bank. 


So easy to use! See your financial totals start to add up before your eyes in less than five minutes! Checks and 
Balances’ cursor can move anywhere, anytime, to add or change entries, and all totals will instantly be updated 
on your screen when you change an amount or move a check to a different category. Checks and Balances gives 
you complete printed reports of the entire register, each category, or reports based on any entry in ‘‘Pay to”’ or 
‘‘Memo’’—even bills and uncashed or missing checks. File size is limited only by your disk capacity. Over 32,000 
entries are possible. 

Technical: 80 x 24 CRT with addressable cursor, reverse video optional. Z-80 processor, one or more disk drives with over 180k capacity. 56k RAM. 


CDE SOFTWARE fot) 








2463 McCready Avenue 
Los Angeles, CA 90039 
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